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

# Text Place

> Insert static text strings at specific locations in documents before signing

A **text place** inserts a static, read-only text value at a specific location in a document. It does not require any action from a recipient. The value is set when the envelope is created and cannot be changed by recipients.

Text places are useful for pre-filling information such as company names, reference numbers, or contract dates before the signing process begins.

<Tip>Use text places with fixed positions to fill in PDF form fields before the first recipient signs.</Tip>

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

## Attributes

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

  For a text place, the value must be `text`.
</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="value" type="string" required={true}>
  The text content to display on the document. This is a static value set when the envelope is created and cannot be changed by the recipient.

  Maximum length is 1000 characters.
</ParamField>

<ParamField body="font_size" type="number">
  The font size in points.

  Must be between 1 and 144. The default is 12.
</ParamField>

<ParamField body="font_color" type="string">
  The font color for this text place. Must be a six-digit hex color code with a leading `#`. Defaults to `#000000` (black).
</ParamField>

## Examples

<CodeGroup>
  ```json Basic Text theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "company_name",
          "type": "text",
          "value": "Lorem Ipsum Ltd",
          "font_size": 12,
          "font_color": "#000000"
        }
      ]
      //...
    }
  ]
  ```

  ```json Pre-fill Date theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "agreement_date",
          "type": "text",
          "value": "January 27, 2026",
          "font_size": 11
        }
      ]
      //...
    }
  ]
  ```

  ```json Large Header Text theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "document_title",
          "type": "text",
          "value": "LOAN AGREEMENT",
          "font_size": 18,
          "font_color": "#000000"
        }
      ]
      //...
    }
  ]
  ```

  ```json Colored Text theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "account_number",
          "type": "text",
          "value": "ACC-2026-00142",
          "font_size": 10,
          "font_color": "#0066cc"
        }
      ]
      //...
    }
  ]
  ```

  ```json Fixed Position (PDF Form Fill) theme={null}
  "documents": [
    {
      //...
      "places": [
        {
          "key": "customer_id",
          "type": "text",
          "value": "CUST-88421",
          "font_size": 10
        }
      ],
      "fixed_positions": [
        {
          "place_key": "customer_id",
          "page": 1,
          "top": 145,
          "left": 200
        }
      ]
      //...
    }
  ]
  ```
</CodeGroup>