> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iinkedsign.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tag options

> Learn about the various options available for template tags.

## Overview

Template tags can be customized using various options to control their behavior and appearance.
These options are specified within the tag syntax and can include properties such as size, alignment, position, validation, default values, and more.

## Options syntax

Options are specified within the template tag using key-value pairs separated by underscores.

<Warning>
  There are two syntaxes for specifying options, some options use the `option_<key>_<value>` syntax, while others use the `<key>_<value>` syntax.
</Warning>

### `option_<key>_<value>`

```handlebars long theme={null}
{{signer_<signer_number>:<tag>_<tag_id>:option_<key>_<value>}}
```

### `<key>_<value>`

```handlebars long theme={null}
{{s_<signer_number>:<tag>_<tag_id>:<key>_<value>}}
```

## PDF units

Many tag options use PDF units for measurements. In PDF units, 1 inch is equal to 72 units.
A standard letter-size document (8.5 x 11 inches) is therefore 612 x 792 PDF units.

## Options

### Optional

The `optional` option allows you to specify whether a tag field is optional or required.

```handlebars long theme={null}
{{signer_1:text_1:option_optional}}
```

```handlebars short theme={null}
{{s_1:text_1:o_opt}}
```

### Width

The `width` option allows you to set the width of the tag field in PDF units.

```handlebars long theme={null}
{{signer_1:text_1:option_width_200}}
```

```handlebars short theme={null}
{{s_1:text_1:o_w_200}}
```

### Height

The `height` option allows you to set the height of the tag field in PDF units.

```handlebars long theme={null}
{{signer_1:text_1:option_height_50}}
```

```handlebars short theme={null}
{{s_1:text_1:o_h_50}}
```

### Font size

The `font_size` option allows you to set the font size of the text within the tag field.

```handlebars long theme={null}
{{signer_1:text_1:option_fontsize_12}}
```

```handlebars short theme={null}
{{s_1:text_1:o_fs_12}}
```

### Align

The `align` option allows you to align the tag field to the left , center, or right within its designated area.

<Tabs>
  <Tab title="left">
    ```handlebars long theme={null}
    {{signer_1:text_1:option_align_left}}
    ```

    ```handlebars short theme={null}
    {{s_1:text_1:o_a_l}}
    ```
  </Tab>

  <Tab title="center">
    ```handlebars long theme={null}
    {{signer_1:text_1:option_align_center}}
    ```

    ```handlebars short theme={null}
    {{s_1:text_1:o_a_c}}
    ```
  </Tab>

  <Tab title="right">
    ```handlebars long theme={null}
    {{signer_1:text_1:option_align_right}}
    ```

    ```handlebars short theme={null}
    {{s_1:text_1:o_a_r}}
    ```
  </Tab>
</Tabs>

## Size

The `size` option allows you to set the size of the tag field (width and height) in PDF units

```handlebars long theme={null}
{{signer_1:text_1:size_(200,50)}}
```

```handlebars short theme={null}
{{s_1:text_1:sz_(200,50)}}
```

## Offset

The `offset` option allows you to set the position offset of the tag field in PDF units.

<Tip>
  Useful for fine-tuning the placement of the tag field, such as `radio` or `checkbox`, within the document.
</Tip>

<Note>
  Positive values move the field right and down, while negative values move it left and up.
</Note>

```handlebars long theme={null}
{{signer_1:text_1:offset_10x-40)}}
```

```handlebars short theme={null}
{{s_1:text_1:f_10x-40)}}
```

## Value

The `value` option allows you to set a default value for the tag field.

<Tip>
  When using default values that contain spaces or special characters, ensure to properly encode them using an URL encoder to avoid parsing issues.
</Tip>

<Note>
  Default `value` can currently be set for `text`, `multiline`, `radio`, and `checkbox` tags.
</Note>

<Tabs>
  <Tab title="Text tag">
    ```handlebars long theme={null}
    {{signer_1:text_1:value_DefaultText}}
    ```

    ```handlebars short theme={null}
    {{s_1:text_1:v_DefaultText}}
    ```
  </Tab>

  <Tab title="Multiline tag">
    ```handlebars long theme={null}
    {{signer_1:multiline_1:value_Default%20multiline%20text.}}
    ```

    ```handlebars short theme={null}
    {{s_1:multi_1:v_Default%20multiline%20text.}}
    ```
  </Tab>

  <Tab title="Radio tag">
    Set a default value of radio `1.1` to `true` (selected).

    ```handlebars long theme={null}
    {{signer_1:radio_1}}
    {{radio_1.1:value_true}}
    {{radio_1.2}}
    {{radio_1.3}}
    ```

    ```handlebars short theme={null}
    {{s_1:r_1}}
    {{r_1.1:v_true}}
    {{r_1.2}}
    {{r_1.3}}
    ```
  </Tab>

  <Tab title="Checkbox tag">
    Set a default value of checkbox `1.1` to `true` (checked).

    ```handlebars long theme={null}
    {{signer_1:checkbox_1.1:value_true}}
    ```

    ```handlebars short theme={null}
    {{s_1:c_1.1:v_true}}
    ```
  </Tab>
</Tabs>

## Data ID

The `dataid` option allows you to assign a custom data identifier to the tag field for easier reference.

```handlebars long theme={null}
{{signer_1:text_1:dataid_customID123}}
```

```handlebars short theme={null}
{{s_1:text_1:id_customID123}}
```

See the [Templating data guide](/v4/guides/template-data) for more information.