> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server
# Customize elastic template fields
> Customize your elastic template by adding fields to your documents and providing customer-specific values for them each time you load the agreement.
You can create customizable fields (also called [tabs](/docs/esign-rest-api/esign101/concepts/tabs)) within an elastic template using the dynamic content feature. *Dynamic content* enables you to add customized field values to each instance of a elastic signing agreement. For example, by defining the full name and email dynamic content for your elastic template, you can supply these values when you load an instance of it to show your user’s name and email within the agreement document.
Dynamic content field values are set when a URL for a elastic signing agreement is created or when it is embedded. They are not directly editable by users.
The following field types are supported:
| Dynamic content field name | JSON element name | Description |
| -------------------------- | ----------------- | ------------------------------------- |
| Full name | `fullName` | A person’s full name. |
| Email | `email` | An email address. |
| Company | `company` | A company name. |
| Job Title | `title` | A job title. |
| Date | `date` | A date and time in YYYY-MM-DD format. |
Each dynamic content field type shares its value with all other fields of the same type in your document. For example, if you define two full name fields, they will both display the same value.
Dynamic content field data is stored in a `documentData` JSON element in your elastic template. The JSON structure of an elastic template with one or more dynamic content fields will look similar to the example below:
```text
{
environment: 'https://demo.docusign.net/',
accountId: '9baa6115-xxxx-xxxx-xxxx-7088b86be96d',
clickwrapId: '77daf49f-xxxx-xxxx-xxxx-726342483864',
clientUserId: 'MyID',
documentData: {
email: 'user@example.com',
fullName: 'myFirstName myLastName',
company: 'Docusign',
title: 'Saint Bernard Wrangler Application',
date: '12/01/2021'
}
},
```
This topic contains the following sections:
* [add dynamic content](/docs/click-api/click101/customize-elastic-template-fields#add-dynamic-content-to-your-elastic-template)
* [View elastic templates that contain dynamic content](/docs/click-api/click101/customize-elastic-template-fields#view-elastic-template-dynamic-content)
* [Set dynamic content as you generate the agreement](/docs/click-api/click101/customize-elastic-template-fields#set-dynamic-content-generate)
* [Set dynamic content as you render the agreement](/docs/click-api/click101/customize-elastic-template-fields#set-dynamic-content-render)
* [Create custom dynamic field types](/docs/click-api/click101/customize-elastic-template-fields#create-custom-dynamic-field-types)
## Add dynamic content to your elastic template
You can only add dynamic content to your elastic templates through the UI, rather than programmatically through the API.
To add dynamic content fields to your elastic template:
1. Open the **Templates** panel in the [eSignature web app](https://apps-d.docusign.com/send/templates/).
2. Select the **Elastic Templates** tab.
3. Open the menu to the right of your chosen elastic template's **COPY CODE** button, then choose **Edit**.
4. Select the document to which you will add the dynamic content, select **Edit**, and then **Edit**.
5. In the **edit** document window, the available fields are displayed in a panel at the left of the screen. Select or drag-and-drop them to add them to your document.
6. Select **SAVE** in the lower right corner of the screen.
7. Select **SAVE** on the **Edit Documents** window.
8. Select **SAVE & CLOSE** in the lower right corner of the screen.
9. Select an option on the **Require Re-acceptance** window and select **SAVE**. If you select **Yes**, returning users who have previously agreed to this elastic template must agree to it again.
10. Select an option on the **Activate New Version** window. If you select **ACTIVATE NOW**, the changes will immediately appear in all websites and apps where the elastic template is embedded.
## View elastic templates that contain dynamic content
You can also embed elastic templates and display customized values for the dynamic content fields they contain.
There are two ways to generate elastic templates that contain dynamic content:
* [Set dynamic content as you generate the agreement](/docs/click-api/click101/customize-elastic-template-fields#set-dynamic-content-generate)**:** In this method, you generate the agreement by passing in the dynamic content values as parameters for the [ClickWraps:createHasAgreed](/docs/click-api/reference/accounts/clickwraps/createhasagreed) API call. This sets the values as the agreement is created, making this the most secure method of setting and viewing dynamic content.
* [Set dynamic content as you render the agreement](/docs/click-api/click101/customize-elastic-template-fields#set-dynamic-content-render)**:** You can also choose to set your dynamic content values as you render the agreement.
> **Note:** For compatibility with previous versions of the Click API, elastic templates use clickwrap endpoints.
### Set dynamic content as you generate the agreement
To set customized values for your elastic template agreement's dynamic content fields as you generate it, follow the steps below:
1. Select the **COPY CODE** button for the elastic template to display. It must be activated and contain dynamic content fields to set.
2. In the elastic template details from step 1 of the **Copy Code** dialog box, copy the `documentData` JSON element and paste it into a place where you can edit text, such as Notepad.
3. The `documentData` values that you just copied are placeholders for each dynamic content field defined in your document. Replace these placeholders values with the ones you want to use when you view the elastic template.
4. Add quotation marks (`"` characters) around the elements within `documentData`. The following screenshot demonstrates a formatted `documentData` element with custom dynamic field values added to it:
5. Generate the viewing URL by making a [ClickWraps:createHasAgreed](/docs/click-api/reference/accounts/clickwraps/createhasagreed) method call, providing your account ID and clickwrap ID in the path. For the call body, choose a unique `clientUserId` for the viewer and add the `documentData` JSON element that you created in the previous step, as shown in the example below.
```text
{
"clientUserId": "ExampleUserID",
"documentData": {
"fullName": "My example name",
"email": "example@docusign.com",
"company": "Docusign",
"title": "Saint Bernard Wrangler",
"date": "2021-12-01"
}
```
**Note**: The [ClickWraps:createHasAgreed](/docs/click-api/reference/accounts/clickwraps/createhasagreed) method requires that you obtain both the `click.manage` and `click.send` scopes during [Authentication](/docs/click-api/click101/auth). If you do not have these scopes, you will receive response code 401 - unauthorized.
6. The [ClickWraps:createHasAgreed](/docs/click-api/reference/accounts/clickwraps/createhasagreed) method call will return a set of data about the created agreement session. The `agreementUrl` field in the response contains the URL of the agreement session that your recipients can use to open and view it. You can do this in two ways:
* You can send the URL directly to your recipient to have them view the agreement session.
* You can use The `agreementUrl` to embed your elastic signing agreement in your web page or app HTML. This enables you to apply your styles to how it is displayed. For example:
```text
```
See [How to embed an elastic signing agreement](/docs/click-api/how-to/embed-elastic-templates) for a more detailed set of step-by-step instructions on how to embed the elastic signing agreement in your app.
### Set dynamic content as you render the agreement
To set customized values for dynamic content fields when embedding your elastic template, use the following steps:
1. Select the **COPY CODE** button for the elastic template to display. It must be activated and contain dynamic content fields to set.
2. Copy the elastic template details from step 1 of the **Copy Code** dialog box.
3. Update the `documentData` JSON element with values for your dynamic content fields. An example set of elastic template details containing the `documentData` JSON is shown below:
```text
```
4. Embed the elastic template as described in this developer guide: [How to embed an elastic signing agreement](/docs/click-api/how-to/embed-elastic-templates).
5. View the responses through your Docusign account on the Manage page or use the Docusign Click API to manage responses. See the [API documentation](/docs/click-api/reference) for details.
## Create custom dynamic field types
Every elastic template has a standard set of supported dynamic fields: full name, email, company, job title, and date. In addition to these standard dynamic fields, you can add your own custom dynamic field types when you create an elastic template with the [ClickWraps:createClickwrap](/docs/click-api/reference/accounts/clickwraps/createclickwrap) endpoint or through the Docusign web app.
To define new dynamic field types with the API:
1. Add a dataFields entry to your elastic template definition JSON.
2. Within this dataFields entry, add an object that contains a label, type (such as string, number, or date), and name for every new dynamic field type to add.
The below example elastic template definition demonstrates the syntax for defining custom dynamic field types for each valid format (string, number, and date) within a JSON elastic template definition.
* Only numeric characters can be input to a number field.
* Date fields can only accept input in mm/dd/yyyy or [ISO Date](https://www.iso.org/iso-8601-date-and-time-format.html) format.
```text
{
"displaySettings": {
"consentButtonText": "I Agree",
"displayName": "Terms of Service",
"downloadable": true,
"format": "modal",
"hasAccept": true,
"mustRead": true,
"requireAccept": true,
"size": "medium",
"documentDisplay": "document"
},
"documents": [
{
"documentBase64": "JVBERi…VPRgo=",
"documentName": "Terms of Service",
"fileExtension": "pdf",
"order": 0
}
],
"dataFields" : [
{
"label": "newLabel1",
"type":"STRING",
"name":"newkey1"
},
{
"label": "newLabel2",
"type":"NUMBER",
"name":"newkey2"
},
{
"label": "newLabel3",
"type":"DATE",
"name":"newkey3"
}
],
"name": "Terms of Service",
"requireReacceptance": true
}
```
3. When you’ve added all of your custom dynamic fields, call the [ClickWraps:createClickwrap](/docs/click-api/reference/accounts/clickwraps/createclickwrap) API endpoint, providing the elastic template JSON that you defined in the previous step. This creates a new elastic template that will include your new types as options when you add dynamic fields.
Use the steps documented in [add dynamic content](/docs/click-api/click101/customize-elastic-template-fields#add-dynamic-content-to-your-elastic-template) to add dynamic content to an elastic template document. Your new custom dynamic field types will appear as options when choosing which dynamic fields to add.
**Note:** You can also create custom dynamic field types through the Docusign web app UI. See [Bulk Import Data Fields to Insert User Data or Add Metadata to Your Documents](https://support.docusign.com/s/document-item?language=en_US\&bundleId=igo1666647424726\&topicId=tvt1660113089575.html&_LANG=enus) for details.
## Next steps
* See [How to create an elastic template](/docs/click-api/how-to/create-elastic-templates)
* See [How to embed an elastic signing agreement](/docs/click-api/how-to/embed-elastic-templates)
* See [ClickWraps:createHasAgreed](/docs/click-api/reference/accounts/clickwraps/createhasagreed)