> ## Documentation Index
> Fetch the complete documentation index at: https://signatureapi-daf4ee54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Signature Place

> Add signature fields to documents using fixed coordinates or text placeholders

A **signature place** marks a specific location in a document where a recipient draws or types their signature. Each signature place is linked to one recipient through the `recipient_key`. A single recipient can have multiple signature places across different pages of a document.

You can position signature places using either [placeholders](/docs/api/resources/places/positioning/#placeholders) or [fixed positions](/docs/api/resources/places/positioning/#fixed-positions).

The width of a signature place is calculated automatically using a 5:2 ratio based on the `height`.

## Attributes

<ParamField body="type" type="enum" required={true}>
  Specifies the type of place.

  For a signature place, the value must be `signature`.
</ParamField>

<ParamField body="key" type="string" required={true}>
  A unique identifier for this place within the document. Use this key to match the place to its position, either through a `[[place_key]]` placeholder in the document or an entry in `fixed_positions`.

  Must start with a lowercase letter and contain only lowercase letters, numbers, and underscores. Maximum 32 characters.
</ParamField>

<ParamField body="recipient_key" type="string" required={true}>
  The key of the recipient assigned to this place. Must match one of the `key` values in the envelope's `recipients` array.
</ParamField>

<ParamField body="height" type="number">
  The height of the signature place in <Tooltip tip="1/72 of an inch">points</Tooltip>. The width is calculated automatically using a 5:2 ratio based on this height.

  Must be between 20 and 60. Defaults to 60.
</ParamField>

## Examples

<CodeGroup>
  ```json Basic (Placeholder) theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "employer_first_signature",
          "type": "signature",
          "recipient_key": "employer",
          "height": 60
        }
      ]
      //...
    }
  ]
  ```

  ```json Fixed Position theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "employer_signature",
          "type": "signature",
          "recipient_key": "employer",
          "height": 60
        }
      ],
      "fixed_positions": [
        {
          "place_key": "employer_signature",
          "page": 2,
          "top": 360,
          "left": 72
        }
      ]
      //...
    }
  ]
  ```

  ```json Multiple Signatures (Same Recipient) theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "employer_signature_page_1",
          "type": "signature",
          "recipient_key": "employer",
          "height": 60
        },
        {
          "key": "employer_signature_page_3",
          "type": "signature",
          "recipient_key": "employer",
          "height": 60
        }
      ]
      //...
    }
  ]
  ```

  ```json Compact Signature theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "employee_signature",
          "type": "signature",
          "recipient_key": "employee",
          "height": 40
        }
      ]
      //...
    }
  ]
  ```
</CodeGroup>

## Sizing guide

The `height` property controls the signature field size in points. It must be between 20 and 60 (default: 60). The width is calculated automatically using a 5:2 ratio (width = height x 2.5).

| Height | Width | Best for                             |
| ------ | ----- | ------------------------------------ |
| 20     | 50    | Tight layouts, small signature lines |
| 40     | 100   | Compact documents with limited space |
| 60     | 150   | Standard documents (default)         |

When using placeholders, the placeholder text (`[[place_key]]`) determines the position only. The rendered signature field uses the dimensions from the `height` property, not the size of the placeholder text.

When using fixed positions, make sure the signature field fits within the page boundaries. A signature placed too close to the edge of a page may be clipped.