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 before using this feature.
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.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 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.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:- Ask the client storage endpoint for an upload URL:
POST /client/{workspaceId}/storagewithsurveyId,elementId(the ID of the Signature element),fileNameset to exactlysignature.png, andfileTypeset toimage/png. The response holdssignedUrl,presignedFieldsandfileUrl. - Upload the PNG file with a multipart form
POSTtosignedUrl, sending everypresignedFieldsentry first and the file last. - Create or update the response and set the Signature element’s answer to the
fileUrlfrom step 1, as one string and not an array:"data": { "<elementId>": "<fileUrl>" }.
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.pnginside 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.