# Signature Field

Use **Signature field** to sign envelopes with an e-ink signature.

You can place this field in:

* structured documents
* PDF documents
* external documents

{% hint style="info" %}
If you add this field to an external document, the document is converted to PDF automatically.
{% endhint %}

### Add a signature field

<figure><img src="/files/8LnNlSgcL1BS5kWqJ4Y8" alt=""><figcaption></figcaption></figure>

1. Open the template in edit mode.
2. In the **Fields** panel find the **Signature field** and add it to the template.
3. Configure the field and click **Save**.

{% hint style="info" %}
The signature date uses the signer’s timezone.

Signed by \[instance name] is shown in the instance default language.
{% endhint %}

### Field settings

Click on the placed field to reopen settings menu.

{% columns %}
{% column width="50%" %}

* **Name** — field name shown in the document
* **Role name** — role that signs in this field
* **Placeholder** — hint text shown before signing (if empty, **Name** is used)
* **Tooltip** — additional hint shown on hover
* **Show signature details** — shows signature details under the signature
  {% endcolumn %}

{% column width="50%" %}

<figure><img src="/files/0FHtbHaWJB4NzASbLuPC" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
If **Show signature details** is enabled, the envelope shows:

* date
* mailbox or email address of the signer
* signature hash
* Signed by \[instance name]

If disabled, only signature hash and Signed by \[instance name] are shown.
{% endhint %}

### Fill a signature field in the envelope

{% columns %}
{% column %}

1. Open the envelope where the signature field is located.
2. Click the signature field.
3. Draw a signature in the modal, or switch to the **Text** tab.
4. Draw for at least **0.5 seconds** to pass validation.
5. Click **Clear** to reset the drawing area (optional).
6. Click **Sign** to apply the signature.
7. Review the details under the signature (depends on **Show signature details**).

Click the signature image to replace it.
{% endcolumn %}

{% column %}

<figure><img src="https://docs.docstudio.com/en/latest/_images/signatureDraw.png" alt="Signature modal" width="420"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
If you have a saved e-ink signature in your profile settings, the modal doesn’t open.

The signature is applied automatically.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.docstudio.com/user/template-builder/template-dynamic-fields/signature-field.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.