# Topaz Signature Pad

A Page Builder block designed specifically for **Topaz** hardware signature pads. Uses the SigWeb browser plugin to communicate directly with the device, capturing a high-fidelity signature and attaching it to the transaction.

For touch-screen or mouse-drawn signatures (or other external devices), use the standard [Signature Pad](/client-admin-guide/active-workflows/getting-started/transaction-components/signature-pad.md) block instead.

## Available in

* Order Form modules **only**

## When to use

* POS or service-order workflows where a physical Topaz signature pad is deployed at the counter.
* Any flow that requires a legal-quality captured signature from a dedicated hardware device.

## Before you start

* A **Topaz** signature pad must be connected to the cashier's computer.
* The **SigWeb** plugin or service must be installed and running on that machine. SigWeb is what allows the browser to talk to the device. Contact your NetSuite Admin or IT team to install it.

## Settings

The block opens a configuration modal:

| Setting                      | Description                                                                                                                                                                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Title**                    | Heading shown above the capture area. Default: *Signature*.                                                                                                                                                                                      |
| **Instruction**              | Helper text shown to the customer. Default: *Please sign below*.                                                                                                                                                                                 |
| **Signature Required Rules** | Conditional rules (using AND/OR logic) that determine when a signature is mandatory before the order can be submitted. For example: "require signature if order total exceeds $500". Leave empty to make signing optional.                       |
| **Target Fields**            | An optional transaction field where the captured signature's file ID is stored. Use this when a downstream workflow or integration needs to read the signature from a specific field. Leave blank to attach the signature to the Files tab only. |

## How it works

1. When the page loads, the block checks whether SigWeb is running locally. If the service isn't detected, the **Sign** button is disabled and a connection message appears.
2. Once SigWeb is connected, the **Sign** button becomes active. The cashier clicks it to activate the pad.
3. The customer signs on the physical Topaz device. A live preview of the signature appears on screen as they write.
4. The customer (or cashier) clicks **Done** to finalize. To start over, click **Re-sign**.
5. The signature is saved as an image and attached to the transaction. If a **Target Field** is configured, the file ID is also written to that field.
6. If **Signature Required Rules** are set and the conditions are met (e.g. order total above a threshold), the Submit Button is blocked until the signature is captured.

{% hint style="warning" %}
If SigWeb is not installed or not running on the cashier's computer, the block will not work. The page will show an error or the capture area will be inactive. Install SigWeb on every machine where this block is used.
{% endhint %}

## Common issues

* **Pad not responding** — confirm SigWeb is running as a local service. Check the system tray or Services panel on the cashier's computer.
* **"SigWeb not found" message** — SigWeb isn't installed. Your IT team needs to install it from the Topaz support site.
* **Signature captures but doesn't attach** — confirm the user has permission to attach files to the transaction in their NetSuite role.

## 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>Signature Pad</strong></td><td>The standard signature block for touch screens and other external devices.</td><td><a href="/pages/9pJ9kroHxLQmoXdCQM1t">/pages/9pJ9kroHxLQmoXdCQM1t</a></td></tr><tr><td><strong>Submit Button</strong></td><td>The submit action that Signature Required can gate.</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/topaz-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.