> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clickterm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Placeholders

> Insert dynamic, user-specific values like name, email, and company into your clickwrap templates.

Placeholders allow you to insert dynamic, user-specific or session-specific values into your template text. These values are passed through your integration when the clickwrap flow is triggered.

## Available placeholders

The following placeholder types are available:

| Placeholder         | Description                                                     |
| ------------------- | --------------------------------------------------------------- |
| Full Name           | End user's full name                                            |
| Email Address       | End user's email                                                |
| Company Name        | Organization name                                               |
| Job Title           | End user's role                                                 |
| Date                | Session-specific date                                           |
| Phone Number        | Contact phone                                                   |
| Address             | Physical address                                                |
| Registration Number | Company registration                                            |
| VAT Number          | VAT identifier                                                  |
| Custom placeholders | User-defined key-value placeholders passed via your integration |

These placeholders help personalize agreements and ensure the final document reflects real user information without modifying the template text manually.

## Custom placeholders

In addition to the built-in fields, you can define your own placeholders with custom keys and values. Each template supports up to 100 custom placeholders.

To learn how to pass custom placeholder values from your integration, see the [developer guide](/dev/guides/placeholders).

## How placeholders work

You can drag any placeholder from the list into the template editor. When dropped, it is inserted as a token inside your text. The same placeholder type can be used multiple times throughout the legal document.

For custom placeholders, you can add new entries, edit existing ones, or remove ones you no longer need. Each template supports up to 100 custom placeholders.

<Frame caption="Template editor with placeholders">
  <img src="https://mintcdn.com/clickterm/BeI2FcE4c6cgA4Ck/product/images/placeholders-template-editor.png?fit=max&auto=format&n=BeI2FcE4c6cgA4Ck&q=85&s=18e3290d3d80068baae8ba3ed0a6b3da" alt="Template editor showing default and custom placeholders" width="1630" height="824" data-path="product/images/placeholders-template-editor.png" />
</Frame>

<Steps>
  <Step title="Your system provides values">
    When triggering a clickwrap session, your integration passes values for relevant placeholders.
  </Step>

  <Step title="ClickTerm replaces tokens">
    ClickTerm automatically replaces placeholder tokens with the actual values.
  </Step>

  <Step title="End user sees the final document">
    The rendered document displays all placeholders filled in with real data.
  </Step>
</Steps>

<Frame caption="Rendered document with filled placeholders">
  <img src="https://mintcdn.com/clickterm/Tkp_GRyJwpuLYp7_/product/images/placeholders-rendered.webp?fit=max&auto=format&n=Tkp_GRyJwpuLYp7_&q=85&s=48b459172a7933ad5b3bbd22436bdc47" alt="Rendered document with filled placeholders" width="1680" height="1622" data-path="product/images/placeholders-rendered.webp" />
</Frame>

<Note>
  If a placeholder value is not supplied, it will appear as a dash (—) in the rendered document.
</Note>

## When to use placeholders

Placeholders are useful when your document needs to include:

* The user's personal details
* Company or account information
* A date that is specific to the signing session

They allow you to avoid creating separate templates for each user or each variable field.

## Related

<CardGroup cols={2}>
  <Card title="Editing content" icon="pen-to-square" iconType="light" href="/product/templates/editing-content">
    Learn how to use the template editor.
  </Card>

  <Card title="Developer guide: Placeholders" icon="code" iconType="light" href="/dev/guides/placeholders">
    How to pass placeholder values from your integration.
  </Card>
</CardGroup>
