Skip to main content
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 or fixed positions. The width of a signature place is calculated automatically using a 5:2 ratio based on the height.

​
Attributes

​
type
enum
required
Specifies the type of place.For a signature place, the value must be signature.
​
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 signature place in . The width is calculated automatically using a 5:2 ratio based on this height.Must be between 20 and 60. Defaults to 60.

​
Examples

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

​
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).
HeightWidthBest for
2050Tight layouts, small signature lines
40100Compact documents with limited space
60150Standard 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.