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

# Signature

> The Signature type lets respondents sign by drawing with a finger, stylus or mouse, or by typing their name. You receive the signature as one PNG image with the response.

> [!NOTE]
>
> **Self-Hosting Requirements**: The Signature type stores the signature as an image, so it requires file
> upload storage to be configured. If you're self-hosting Formbricks, make sure to [configure file
> uploads](https://formbricks.com/docs/self-hosting/configuration/file-uploads.md) before using this feature.

Use Signature to collect a signature as part of a survey, for example a confirmation on a form, a consent on site or a sign-off on a tablet. It is available on every plan.

## Elements

### Title

Add a clear title that tells the respondent what they are signing.

### Description

Provide an optional description, for example the text or terms the signature applies to.

### Required

A Signature is required by default. A required Signature that is left empty blocks the respondent on **Next** with the usual required message. Turn the setting off and the respondent can skip it.

### Allow typed signature

On by default. The respondent sees a **Draw** and **Type** switch above the signature pad. In **Type**, they enter their name with the keyboard, up to 60 characters, and it is shown in a cursive script that fits the pad. Switching between the two keeps what was entered until the respondent selects **Clear**. When both a drawing and a typed name exist, the tab that is visible when the respondent selects **Next** (**Draw** or **Type**) is the signature that is saved.

Turn the setting off to hide the switch, so respondents can only draw.

> [!WARNING]
>
> Keep typed signatures on unless you have another way for people to answer. Drawing needs a pointing device or
> a touch screen, so respondents who use a keyboard or a screen reader cannot complete a drawn-only required
> Signature. When the setting is off and the question is required, the editor warns you about this.

## How respondents sign

On a phone or tablet, the respondent draws with a finger or a stylus. The pad does not scroll the page while they draw. On a computer, they draw with the mouse. They can select **Clear** at any time and sign again, and the signature is kept if they rotate the device or go back to the question.

A signature counts as signed once the respondent has drawn a stroke of minimum length or typed a name with at least one letter, number or symbol. A single tap, an empty name, or a name of only spaces or punctuation does not count, so it does not satisfy a required Signature.

The image is saved when the respondent selects **Next**, not while they draw. If saving fails, they see an error and stay on the question.

## Logic

Use a Signature in [logic](https://formbricks.com/docs/surveys/general-features/conditional-logic.md) with these conditions:

* **Is signed**: the respondent drew or typed a signature.
* **Is not signed**: the respondent skipped the question. Logic offers this condition only while **Required** is off, because a required Signature cannot be skipped. The editor shows a note about it under the settings of a required Signature.

## What is stored

Each signature is stored as one PNG image, always 900 by 300 pixels, with an opaque white background and near-black ink, whichever way the respondent signed and on whichever device. Formbricks does not store whether the signature was drawn or typed, and it does not store the typed name as text. A signature image is about 35 KB, and Formbricks accepts at most 1 MB per signature, whatever the file size limit for file uploads is on your plan.

Typed names use the Dancing Script font. It covers Latin and Latin Extended-A characters. A name in another script, such as Cyrillic or Chinese, is shown in the browser's own cursive font, so how it looks depends on the respondent's device.

> [!NOTE]
>
> A signature is an image plus the response timestamp. Formbricks does not add an audit trail or tamper
> evidence, and a Signature does not make a survey a legally binding electronic signature. Check what
> your use case requires before relying on it.

## Submit a signature through the API

A client that is not the Formbricks survey, such as your own form, uploads the image first and then submits its URL as the answer:

1. Ask the client storage endpoint for an upload URL: `POST /client/{workspaceId}/storage` with `surveyId`, `elementId` (the ID of the Signature element), `fileName` set to exactly `signature.png`, and `fileType` set to `image/png`. The response holds `signedUrl`, `presignedFields` and `fileUrl`.
2. Upload the PNG file with a multipart form `POST` to `signedUrl`, sending every `presignedFields` entry first and the file last.
3. Create or update the response and set the Signature element's answer to the `fileUrl` from step 1, as one string and not an array: `"data": { "<elementId>": "<fileUrl>" }`.

Only a PNG named `signature.png` up to 1 MB is accepted. The endpoint refuses any other file name or extension, storage refuses a larger file, and a response whose answer is not a file uploaded this way for that element is rejected.

## Where to find signatures

* **Responses**: the response card shows the signature image with a **Download PNG** button. The downloaded file is named `signature-<response ID>.png`, so several downloads stay apart and each one traces back to its response. In the responses table, the signature column shows a small thumbnail that opens the full image in a new tab.
* **Summary**: the question shows how many respondents signed and how many skipped it, and thumbnails of the latest signatures, 10 at first and up to 50 with **Load more**. Select a thumbnail to open its response.
* **CSV and Excel export**: the column named after the question holds the full image URL, or nothing for a skipped question.
* **Attachments**: **All attachments (ZIP)** in the download menu includes the signature images next to any file uploads, as `signature.png` inside a folder per response and question.
* **API and webhooks**: the answer is the image URL as a string. In the v3 API a signature answer has the shape `{ "elementType": "signature", "imageUrl": "..." }`. Webhooks and integrations such as Google Sheets, Airtable, Slack and Notion receive the URL as well.

## Privacy and retention

Signature images are private. Opening an image URL requires you to be logged in to Formbricks with access to the workspace, or to send an API key. Sharing a URL with someone who has no access does not give them the image.

For this reason the links are not included in email notifications or in email follow-ups. The email notes that the link is not included for data privacy reasons.

The image follows the response. When a response is deleted, including when a data retention policy removes it or when you delete or reset the survey, its signature image is deleted too and the URL stops working. This also holds for a question you have deleted or changed to another question type: the images already collected stay with their responses until those responses are deleted. Download the images you need to keep before then.

When a respondent selects **Clear** or signs again, and then continues, the earlier image is deleted when the response is updated and its URL stops working. The same applies when you or an API client change or remove the signature of an existing response. Formbricks removes these images in the background, so it can take a few minutes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.