Skip to main content

E-Signature Component

CraftMyPDF integrates with Documenso to provide enterprise-grade electronic signatures that comply with the ESIGN Act, UETA, and eIDAS (SES).

When E-Signature is enabled on a PDF template, CraftMyPDF automatically creates a Documenso envelope after each PDF generation, assigns your configured fields to the specified recipients, and sends signing requests by email.

How It Works

  1. Design - Enable E-Signature on a PDF template, configure signing order, envelope details, expiration, and recipients, then place E-Signature fields on the page.
  2. Generate - Generate a PDF through the API, Merge API, or dashboard. CraftMyPDF renders the PDF and queues a Documenso envelope for processing.
  3. Sign - Recipients receive an email with a unique signing link and complete their assigned actions (sign, approve, view, or assist).
  4. Track - Monitor document status and download completed PDFs from the Signed Documents page in your dashboard.
note

E-Signature is available only for PDF templates. It is not available in Preview mode.

Configure E-Signature

Open your PDF template in the designer and select the E-Signature tab in the settings panel. The tab is organized into four sections that match the topics below: signing order, envelope details, envelope expiration, and recipients.

E-Signature settings tab in the template designer

To enable E-Signature for your template, check Enable E-Signature.

When enabled, CraftMyPDF creates a Documenso envelope after PDF generation and assigns the configured fields to the recipients below.

Signing Order

By default, all recipients receive the document at the same time and can complete their actions in any order (parallel signing). You can change this to require recipients to act in a specific sequence.

All recipients receive the document simultaneously. The document is completed when everyone finishes their required actions. Use this when:

  • The order does not matter
  • You want the fastest completion time
  • Recipients are independent of each other

Envelope Details

Optionally customize the email subject and message that recipients receive. These values are sent to Documenso as envelope metadata.

Subject and message fields in the Envelope Details section

Subject (Optional)

Customize the email subject line. If left blank, Documenso generates a default subject based on the recipient's role:

  • Signers: CraftMyPDF invited you to sign a document
  • Approvers: CraftMyPDF invited you to approve a document
  • Viewers: CraftMyPDF invited you to view a document
  • Assistants: CraftMyPDF invited you to assist a document

Message (Optional)

Add a custom message that appears in the email body. You can use these variables:

  • {signer.name} - Recipient's name
  • {signer.email} - Recipient's email
  • {document.name} - Document title

If left blank, a default message is generated based on the recipient's role.

Example signing request email with custom subject and message

See also the What Recipients Receive section.

Envelope Expiration

Optionally set a signing deadline so recipient links expire after a configurable period.

By default, envelope expiration is disabled, and signing links remain valid until the document is completed, rejected, or cancelled.

To enable expiration:

  1. Check Enable expiration
  2. Set the Expiration Amount and Expiration Unit (day, week, month, or year)

When enabled, the default expiration is 30 days. Recipients must complete their actions before the deadline, or their signing link expires.

Envelope expiration settings

Recipients

Recipients table in the E-Signature tab

Add one or more recipients who will receive the document. Each recipient is assigned a unique Recipient ID (for example, recipient_1). Use this ID when assigning E-Signature fields on the template.

Recipient name and email fields support both static values and expressions. For example, given the following JSON data:

{
"signers": [
{
"name": "Signer 1",
"email": "signer1@example.com"
},
{
"name": "Signer 2",
"email": "signer2@example.com"
}
],
"approverName": "Approver",
"approverEmail": "approver@example.com"
}
ExpressionEvaluates to
{{ data.signers[0].name }}Signer 1
{{ data.signers[0].email }}signer1@example.com
{{ data.signers[1].name }}Signer 2
{{ data.signers[1].email }}signer2@example.com
{{ data.approverName }}Approver
{{ data.approverEmail }}approver@example.com

Role Overview

RoleAction RequiredCan SignDescription
SignerYesYesMust sign the document
ApproverYesOptionalMust approve the document
ViewerYesNoMust view the document
CCNoNoReceives a copy after completion
AssistantYesNoCan pre-fill fields for other recipients

Role Details

note

Each signer must have at least one Signature field assigned to them.

Signers are the primary recipients of a document. They must complete all signature fields assigned to them before the document can be finalized.

What they can do:

  • Sign signature fields assigned to them
  • Fill out any other fields assigned to them (text, date, checkbox, and so on)
  • Download the document after signing

What they cannot do:

  • Sign on behalf of other recipients
  • Modify fields assigned to other recipients

When to use this role:

  • Contracts requiring a legally binding signature
  • Agreements where the recipient must formally consent
  • Any document that requires a signature to be valid

Placing E-Signature Fields

E-Signature field types in the Components panel

After configuring recipients, drag E-Signature field components from the Components panel onto your template. Ten field types are available under E-Signature Fields:

Signature, Email, Name, Initials, Date, Text, Number, Radio, Checkbox, and Dropdown.

For each field:

  1. Select the field on the canvas
  2. In the property panel, choose the Recipient that should complete the field
  3. Configure field-specific options as needed
note

Every E-Signature field must be assigned to a recipient.

Field TypeDescriptionAuto-filled
SignatureRecipient's signature (drawn, typed, or uploaded)No
InitialsRecipient's initialsNo
EmailRecipient's email addressYes
NameRecipient's full nameYes
DateDate the field was completedYes
TextFree-form text inputNo
NumberNumeric input with optional validationNo
RadioSingle selection from a list of optionsNo
CheckboxMultiple selections from a list of optionsNo
DropdownSingle selection from a dropdown menuNo

Signature

note

Each signer must have at least one Signature field assigned to them.

The signature field captures the recipient's legally binding signature. Recipients can:

  • Draw their signature using a mouse or touchscreen
  • Type their name and select a font style
  • Upload an image of their signature

Configuration Options

Signature field configuration options

OptionDescriptionDefault
Font sizeSize of the text in the field (8-96px)18px

Initials

The initials field captures abbreviated signatures, typically used to acknowledge individual pages or clauses.

Configuration Options

Initials field configuration options

OptionDescriptionDefault
Font sizeSize of the text in the field (8-96px)12px
Text alignLeft, center, or right alignmentLeft

Email

The email field displays the recipient's email address. This field is automatically populated with the email address used to send the signing request.

Configuration Options

Email field configuration options

OptionDescriptionDefault
Font sizeSize of the text in the field (8-96px)12px
Text alignLeft, center, or right alignmentLeft

Name

The name field captures the recipient's full name. When the recipient has a name on file, the field can be auto-populated.

Configuration Options

Name field configuration options

OptionDescriptionDefault
Font sizeSize of the text in the field (8-96px)12px
Text alignLeft, center, or right alignmentLeft

Date

The date field records when the recipient completed the field or signed the document. By default, it auto-fills with the current date.

Configuration Options

Date field configuration options

OptionDescriptionDefault
Font sizeSize of the text in the field (8-96px)12px
Text alignLeft, center, or right alignmentLeft

Text

The text field accepts free-form text input from recipients. Use this for any information that does not fit other field types.

Configuration Options

Text field configuration options

OptionDescriptionDefault
LabelDisplay text shown above the fieldNone
PlaceholderHint text shown when the field is emptyNone
Font sizeSize of the text in the field (8-96px)12px
Text alignLeft, center, or right alignmentLeft
Vertical alignVertical alignment of the textMiddle
RequiredWhether the field must be completedfalse
Read-onlyLock the field with a pre-filled valuefalse
Line heightSpacing between lines of text1
Letter spacingSpacing between characters0
Character limitMaximum number of characters allowedNone
Default valuePre-filled text that recipients can modifyNone

Rules

  • A field cannot be both required and read-only at the same time
  • A read-only field must have a default text value (it cannot be empty)
  • If a default text value is set, the field is inserted into the document automatically
  • The text entered cannot exceed the character limit
  • Recipients cannot modify a read-only field

Number

The number field accepts numeric input with optional validation constraints.

Configuration Options

Number field configuration options

OptionDescriptionDefault
LabelDisplay text shown above the fieldNone
PlaceholderHint text shown when the field is emptyNone
Font sizeSize of the text in the field (8-96px)12px
Text alignLeft, center, or right alignmentLeft
Vertical alignVertical alignment of the textMiddle
RequiredWhether the field must be completedfalse
Read-onlyLock the field with a pre-filled valuefalse
Line heightSpacing between lines of text1
Letter spacingSpacing between characters0
Number formatDisplay format for the numberNone
Min valueLowest allowed numberNone
Max valueHighest allowed numberNone
Default valuePre-filled number that recipients can modifyNone

Rules

  • The value must be a number
  • A field cannot be both required and read-only at the same time
  • A read-only field must have a default number value
  • If both a default number and a maximum value are set, the default must be less than the maximum
  • If both a default number and a minimum value are set, the default must be greater than the minimum
  • The value must match the number format if one is set

Radio

The radio field presents a list of options where the recipient can select exactly one.

Configuration Options

Radio field configuration options

OptionDescriptionDefault
Font sizeSize of the text in the field (8-96px)12px
RequiredWhether a selection must be madefalse
Read-onlyLock the field with a pre-selected valuefalse
DirectionVertical or horizontal layoutVertical
OptionsList of selectable values

Rules

  • A field cannot be both required and read-only at the same time
  • A read-only field must have at least one option
  • If a default value is set, the field is automatically marked as complete
  • Recipients cannot select a value that is not in the options list
  • Only one option can be selected at a time

Checkbox

The checkbox field presents a list of options where the recipient can select multiple items.

Configuration Options

Checkbox field configuration options

OptionDescriptionDefault
Font sizeSize of the text in the field (8-96px)12px
RequiredWhether at least one selection must be madefalse
Read-onlyLock the field with pre-selected valuesfalse
Validation ruleRules for minimum/maximum selectionsNone
DirectionVertical or horizontal layoutVertical
OptionsList of selectable values

Rules

  • A field cannot be both required and read-only at the same time
  • A read-only field must have at least one checked option
  • If default values are set, the field is automatically marked as complete
  • The validation rule enforces selection counts: "At least", "At most", or "Exactly" a specified number of options
  • Recipients cannot select a value that is not in the options list

The dropdown field presents a list of options in a collapsible menu. Recipients select one option from the list.

Configuration Options

Dropdown field configuration options

OptionDescriptionDefault
Font sizeSize of the text in the field (8-96px)12px
RequiredWhether a selection must be madefalse
Read-onlyLock the field with a pre-selected valuefalse
Default valuePre-selected option
OptionsList of selectable values

Rules

  • A field cannot be both required and read-only at the same time
  • A read-only field must have a default value
  • The default value must be one of the options
  • If a default value is set, the field is automatically marked as complete
  • Recipients cannot select a value that is not in the options list

What Recipients Receive

Example signing request email sent to a recipient

When a document is generated and sent, each recipient receives an email with:

  • The document title (from your custom subject or the default for their role)
  • Your custom messag3e (or a default message)
  • A button to open and complete their assigned actions

The email includes a unique signing link for that recipient. The link expires when the document is completed, rejected, cancelled, or when the envelope expiration deadline is reached (if configured).

Document Lifecycle

A document progresses through the following states:

StateDescription
QueuedThe document is waiting to be processed
ProcessingThe document is being sent to Documenso
CreatedThe envelope was created but has not yet been sent to recipients
SentThe document has been sent and is awaiting recipient actions
CompletedAll recipients have completed their required actions
RejectedA recipient rejected the document
FailedProcessing failed. Common causes include invalid template configuration and validation errors. Contact support if you need help.
CancelledThe document was permanently deleted from Documenso. Contact customer support to request cancellation.

Manage Signed Documents

Signed Documents page in the dashboard

Open Signed Documents from your dashboard (next to Manage Templates) to view all E-Signature documents generated from your templates.

The table shows each document's template, transaction reference, recipient count, status, and timestamps. Filter by template ID or status to find specific documents.

Available actions depend on the document status:

ActionDescription
Retry SendResend a document that was created but failed to distribute to recipients
Signing LinksView and copy individual signing URLs for each recipient
DownloadDownload the signed PDF (available for sent and completed documents)