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

# Initials Place

> Add initials fields to documents for recipients to place their initials during signing

An **initials place** marks a specific location in a document where a recipient enters their initials. Each initials place is linked to one recipient through the `recipient_key`. A single recipient can have multiple initials places across different pages.

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

The width of an initials place equals its height (a square field).

## Attributes

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

  For an initials place, the value must be `initials`.
</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 initials place in <Tooltip tip="1/72 of an inch">points</Tooltip>. The width equals the height.

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

## Examples

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

  ```json Fixed Position theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "employer_initials",
          "type": "initials",
          "recipient_key": "employer",
          "height": 40
        }
      ],
      "fixed_positions": [
        {
          "place_key": "employer_initials",
          "page": 1,
          "top": 720,
          "left": 500
        }
      ]
      //...
    }
  ]
  ```

  ```json Initials on Multiple Pages theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "client_initials_p1",
          "type": "initials",
          "recipient_key": "client",
          "height": 30
        },
        {
          "key": "client_initials_p2",
          "type": "initials",
          "recipient_key": "client",
          "height": 30
        },
        {
          "key": "client_initials_p3",
          "type": "initials",
          "recipient_key": "client",
          "height": 30
        }
      ],
      "fixed_positions": [
        {
          "place_key": "client_initials_p1",
          "page": 1,
          "top": 720,
          "left": 520
        },
        {
          "place_key": "client_initials_p2",
          "page": 2,
          "top": 720,
          "left": 520
        },
        {
          "place_key": "client_initials_p3",
          "page": 3,
          "top": 720,
          "left": 520
        }
      ]
      //...
    }
  ]
  ```

  ```json Compact Initials theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "witness_initials",
          "type": "initials",
          "recipient_key": "witness",
          "height": 25
        }
      ]
      //...
    }
  ]
  ```
</CodeGroup>