Skip to main content
Date places insert completion timestamps automatically at a specific location in a document. There are two types: one that records when a specific recipient completed their action, and one that records when the entire envelope was completed. You can position date places using either placeholders or fixed positions.

​
Date Format

Both date place types accept a date_format property that controls how the date is rendered. Use Moment.js format syntax. The default format is D MMM YYYY, which renders as 31 Dec 2025. Common formats:
Format stringExample output
D MMM YYYY31 Dec 2025
YYYY-MM-DD2025-12-31
MM/DD/YYYY12/31/2025
MMMM D, YYYYDecember 31, 2025
DD/MM/YYYY HH:mm31/12/2025 14:30

​
Recipient Completed Date

A recipient completed date place records the date and time when the specific recipient identified by recipient_key completed their action on the envelope.

​
Example

"documents": [
  {
    //...
    "places": [
      {
        "key": "employer_signed_at",
        "type": "recipient_completed_date",
        "recipient_key": "employer",
        "date_format": "YYYY-MM-DD"
      }
    ]
    //...
  }
]

​
Attributes

​
type
enum
required
Specifies the type of place.For this kind of place, the value must be recipient_completed_date.
​
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.
​
date_format
string
The date and time format using Moment.js syntax. Common formats include D MMM YYYY (31 Dec 2025), YYYY-MM-DD (2025-12-31), and MM/DD/YYYY (12/31/2025).Defaults to D MMM YYYY.
​
font_size
number
The font size in . Must be between 1 and 144. Defaults to 12.

​
Envelope Completed Date

An envelope completed date place records the date and time when the entire envelope was completed, meaning all recipients have finished their actions. This place type does not require a recipient_key because it applies to the envelope as a whole.

​
Example

"documents": [
  {
    //...
    "places": [
      {
        "key": "signed_by_all_at",
        "type": "envelope_completed_date",
        "date_format": "MM/DD/YYYY HH:mm"
      }
    ]
    //...
  }
]

​
Attributes

​
type
enum
required
Specifies the type of place.For this kind of place, the value must be envelope_completed_date.
​
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.
​
date_format
string
The date and time format using Moment.js syntax. Common formats include D MMM YYYY (31 Dec 2025), YYYY-MM-DD (2025-12-31), and MM/DD/YYYY (12/31/2025).Defaults to D MMM YYYY.
​
font_size
number
The font size in . Must be between 1 and 144. Defaults to 12.

​
More Examples

"documents": [
  {
    //...
    "places": [
      {
        "key": "signed_date",
        "type": "recipient_completed_date",
        "recipient_key": "signer",
        "date_format": "YYYY-MM-DD"
      }
    ]
    //...
  }
]