> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: $w

## Namespace: signature-input

## Article: Introduction

## Article Link: https://dev.wix.com/docs/velo/velo-only-apis/$w/signature-input/introduction.md

## Article Content:

# Introduction
Before working with this API, you must add a signature element to your page. In the
 Wix Editor, add a **Signature** and a **Submit** button to a form on your
 page. The signature element comes with a signature pad and a built-in **Clear**
 button. After the site visitor draws their signature on the pad and submits the form,
 the `SignatureInput` element's [`value`](#value) is populated with a base64-encoded
 Data URL representing a PNG image of the signature.

 The `SignatureInput` APIs work with both Wix Forms and custom forms, which are forms you
 manually create by adding user input elements and a submit button to your page.

 With code, you can use the `SignatureInput` API to:

 + Save the signature to a collection as an inline image in a field of type **Image**.
 + Clear the signature from the signature pad with the [`clear()`](#clear) function.
 + Use the [`onChange()`](#onChange) event handler to detect if the signature value changed or was cleared.
 + Set the element's properties and events, such as **Hidden on load** and **onMouseIn**.
 + Send a signature by email as an attachment, such as with a service like SendGrid. Tip: Make sure to strip out the "**data:image/png;base64,**" prefix from the signature `value` before attaching.



 **Using Signatures with Wix Forms**:

 Wix Forms automatically adds the signature to the Media Manager and to the collection generated for you by Wix Forms, so
 you do not have to code this functionality unless working with another collection.


 **About Inline Images in Collections**:

 + Saving a signature as an inline image in a collection is supported because signatures are relatively small in size. We do not recommend that you store other types of images inline in collections for performance reasons.
 + You cannot preview inline images in collections generated by apps that do not use the new Wix Content Management System (CMS), such as Wix Forms. To make sure you can preview, we recommend you do not store inline images in collections generated by Wix Forms.