Signature Pad Field

Capture handwritten signatures using an HTML5 canvas-based signature pad.

Overview

The signature field type gives users a canvas where they can draw their signature with a mouse, trackpad or touch input. Signatures are saved as image files and validated by the FileFieldValidator.

Basic Usage

Use addSignature() to add a signature pad. You can set the canvas dimensions and colors.

app/Actions/CreateContractForm.php

Customizing the Signature Pad

Adjust the canvas size and colors to fit your design. Larger canvases give users more room for detailed signatures.

app/Actions/CreateAgreementForm.php

Available Settings

SettingTypeDefaultDescription
widthinteger600Width of the signature canvas in pixels.
heightinteger200Height of the signature canvas in pixels.
pen_colorstring#000000Color of the signature pen/stroke in hex format.
background_colorstring#FFFFFFBackground color of the signature canvas in hex format.

Validation

The FileFieldValidator checks:

  • A signature has been drawn (canvas is not empty)
  • The generated image file meets any configured file size limits
  • Required/optional status based on field configuration

Common Use Cases

  • Contract and agreement signing
  • Terms of service acceptance
  • Medical consent forms
  • Delivery confirmations
  • Legal documents requiring authentication
  • Parental consent forms