# Signature Pad

A canvas where the user can draw a signature with finger, mouse, or stylus — or capture from an external signature device (PIN pad, dedicated signature pad, DeviceBridge). The captured signature uploads automatically as an attachment to the transaction.

![Signature Pad canvas with a drawn signature, a Clear button, and a Save button below](/files/o8NmJfBqfhXKU9LXCtXL)

## Available in

* Order Form modules **only**

## When to use

* Order confirmation flows where the customer signs to acknowledge receipt or terms.
* Delivery acknowledgement screens.
* Service-order workflows that require a signed authorisation.
* Any process that needs proof-of-acceptance.

## Settings

| Setting             | Description                                                                                                                                                                                                                                                     |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Title**           | Heading text shown above the pad. Default: *Signature*.                                                                                                                                                                                                         |
| **Instruction**     | Helper text shown below the title. Default: *Please sign below*.                                                                                                                                                                                                |
| **Capture Methods** | both (touch + device), touch (canvas only), or device (external pad only). Default: both.                                                                                                                                                                       |
| **Auto Upload**     | Yes — auto-upload on device capture. No — require manual save. Default: Yes.                                                                                                                                                                                    |
| **Show Preview**    | Show a preview of the captured signature. Default: Yes.                                                                                                                                                                                                         |
| **Target Fields**   | One or more transaction fields the captured signature is written to (in addition to attaching as a file). Configure this when a downstream workflow or SuiteScript reads the signature from a specific transaction field rather than from the attachments list. |

## How it works

1. Renders a high-DPI canvas for touch/mouse input.
2. If capture method = device or both, also offers an external-device capture path via PIN pad / external signature pad / DeviceBridge APIs.
3. **Auto Upload** on device capture sends the signature directly without an extra confirm step. Touch capture requires a manual Save click.
4. Saves as a PNG attachment named `{brmOrderId}_signature_{timestamp}.png`.
5. Attaches to the transaction via `setAttachmentsData` so it submits with the order.
6. Clears automatically on `formResetAfterSubmission`.

{% hint style="info" %}
For card-present POS terminals with built-in signature capture, configure Capture Methods = device and Auto Upload = Yes — the cashier doesn't need to touch the screen at all.
{% endhint %}

## Examples

**Customer signature on POS receipt.** Signature Pad with Capture Methods = both, Auto Upload = Yes. Customer signs on the cashier's tablet or the EMV terminal; signature attaches to the order.

**Delivery confirmation.** Signature Pad with Title = *Sign for Delivery*, Capture Methods = touch, Auto Upload = No. Driver hands tablet to recipient who signs and confirms.

**Service authorisation.** Signature Pad on a quote-acceptance flow. Captures customer agreement before submitting the work order.

## Related

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Attachments</strong></td><td>The general-purpose attachment block — Signature Pad uses the same attachment store.</td><td><a href="/pages/cmDBwRLTAhy4sPsvNMwU">/pages/cmDBwRLTAhy4sPsvNMwU</a></td></tr><tr><td><strong>Submit Button</strong></td><td>The block that submits the order with attached signature.</td><td><a href="/pages/PhZ3dkc4a1LxD8vQ0aja">/pages/PhZ3dkc4a1LxD8vQ0aja</a></td></tr></tbody></table>


---

# 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://docs.in8sync.com/client-admin-guide/active-workflows/getting-started/transaction-components/signature-pad.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.
