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 or fixed positions.

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

Attributes

type · enum · required

Specifies the type of place.

For an initials place, the value must be initials.

key · string · required

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.

recipient_key · string · required

The key of the recipient assigned to this place. Must match one of the key values in the envelope’s recipients array.

height · number

The height of the initials place in points. The width equals the height.

Must be between 20 and 60. Defaults to 60.

Examples

Basic (Placeholder)

"documents": [
  {
    //...
    "places": [
      {
        "key": "employer_initials",
        "type": "initials",
        "recipient_key": "employer",
        "height": 60
      }
    ]
    //...
  }
]