---
title: "Initials Place"
description: "Add initials fields to documents for recipients to place their initials during signing"
canonical: "https://signatureapi.com/docs/api/resources/places/initials"
source: "https://signatureapi.com/docs/api/resources/places/initials.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T11:48:11Z"
---

# Initials Place

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

_Last verified against API version 1.18.0._

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](https://signatureapi.com/docs/api/resources/places/positioning/#placeholders) or [fixed positions](https://signatureapi.com/docs/api/resources/places/positioning/#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)

```json
{
  "key": "employer_initials",
  "type": "initials",
  "recipient_key": "employer",
  "height": 60
}
```

#### Fixed Position

```json
{
  "documents": [
    {
      "places": [
        {
          "key": "employer_initials",
          "type": "initials",
          "recipient_key": "employer",
          "height": 40
        }
      ],
      "fixed_positions": [
        {
          "place_key": "employer_initials",
          "page": 1,
          "top": 720,
          "left": 500
        }
      ]
    }
  ]
}
```

#### Initials on Multiple Pages

```json
{
  "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
        }
      ]
    }
  ]
}
```

#### Compact Initials

```json
{
  "key": "witness_initials",
  "type": "initials",
  "recipient_key": "witness",
  "height": 25
}
```
