> ## 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.

# Signer tags

> Learn how to associate template tags with signers using user-defined identifiers.

## Overview

Signer tags let you associate document template tags with signers using meaningful identifiers instead of their position in the signing order. Set the `signerTag` property for a signer when you call `POST /packages/add`, then use the same identifier in the document's template tags.

For example, a signer with a `signerTag` value of `buyer` is associated with these template tags:

```handlebars long theme={null}
{{signer_buyer:signature_1}}
```

```handlebars short theme={null}
{{s_buyer:sig_1}}
```

The user-defined identifier replaces the signer's generated numeric or host identifier. For example, use `signer_buyer` rather than `signer_1` for a signer whose `signerTag` is `buyer`.

<Note>
  If you omit `signerTag`, iinked Sign generates the signer identifier based on the package type and signing order. Generated identifiers include `signer_1` and `signer_host`.
</Note>

## Choose signer tag values

Use a unique, lowercase value without underscores for each signer. Template tag identifiers are read as lowercase, and underscores separate parts of the template tag syntax.

For example, use `buyer` and `seller` as the `signerTag` values, then add `signer_buyer` and `signer_seller` template tags to the document.

## Add a package with signer tags

Before adding the package, insert template tags that use the user-defined signer identifiers into the document. For example:

```handlebars theme={null}
Buyer signature: {{signer_buyer:signature_1}}
Seller signature: {{signer_seller:signature_1}}
```

Upload the document, then call `POST /packages/add`. Set each signer's `signerTag` to the identifier used in the document:

```http Request theme={null}
POST /packages/add
{
    "name": "Purchase Agreement",
    "type": "sequential",
    "signers": [
        {
            "signerTag": "buyer",
            "firstName": "Jamie",
            "lastName": "Buyer",
            "email": "jamie.buyer@example.com"
        },
        {
            "signerTag": "seller",
            "firstName": "Alex",
            "lastName": "Seller",
            "email": "alex.seller@example.com"
        }
    ],
    "documents": [
        {
            "fileName": "purchase-agreement.pdf",
            "fileId": "d29e25e0-624b-4adb-b118-19c4d0125e5e"
        }
    ]
}
```

When iinked Sign processes the document, fields using `signer_buyer` are assigned to Jamie Buyer and fields using `signer_seller` are assigned to Alex Seller.