Documents applicants sign

A verification can ask the applicant to sign a document. You write the document once, publish a version of it, and point a Document signing step at that version. Every applicant who reaches the step gets the document filled in with their own details, signs it by typing their name, and receives a sealed PDF with a certificate of completion.

Documents live under Documents in the console sidebar, next to Workflows, because authoring a document and authoring a workflow are the same job. A document is only ever reached from a workflow step.

Before you start

Three things have to be in place, and the console tells you which one is missing:

• An authorized signatory. This is the person who signs on your organization’s behalf, and it is set once for the whole organization under Settings → Organization → Authorized signatory. Signing steps cannot run until it is set. Changing it later does not rewrite documents that were already signed.
• An Identity information step earlier in the same workflow template. The document’s applicant fields are filled from what that step collects, so the signing step cannot be saved without it.
• A role that can author. Owner, Admin, and Manager can create, edit, and publish documents. Member can read them. Setting the organization signatory is Owner and Admin only.

Create a document

1. Open Documents and select Create a document.
2. Give it a Name and, optionally, a Description. Both are for your team; the signer never sees either.
3. Pick a Document type. This is recorded with the document and cannot be left blank. The options are Rental or lease agreement, Service or sales agreement, Employment or contractor agreement, Nondisclosure or confidentiality agreement, Consent or authorization, Disclosure or acknowledgment, Waiver or release, and Something else. The last one is there so you are never forced to mis-describe a real agreement to get it signed.
4. Read the list of documents that cannot be signed electronically and confirm yours is not one of them. This is a legal boundary, not a policy of ours: US law puts wills, family-law matters, court documents, and several kinds of cancellation and default notice outside electronic signing. The full list, and the two cases that look like carve-outs but are not, are on Electronic signatures.

Write the content

The editor is a plain rich-text editor. The toolbar gives you bold, italic, underline, a heading, bulleted and numbered lists, a quote block, a table, and a divider. Numbered lists are the normal shape for numbered clauses, and a table is the normal shape for a fee or payment schedule.

Two buttons do different things:

• Save draft stores your work. A draft is editable and is not signed by anyone.
• Publish version freezes the current content as a numbered version. A published version can never be edited, which is what lets a signed document be checked years later against exactly the text that was signed. To change a published document, edit the draft and publish again; the new version does not disturb anything already signed under the old one.

Fill in details with variables

A variable is a placeholder that resolves once, when the applicant’s document is prepared, and never afterward. That is what makes the signed PDF a fixed record rather than a page that re-renders differently later.

There are two ways to place one, and both open the same picker:

• Select Insert variable, under the toolbar. The picker lists every variable, narrows as you type, and moves with the arrow keys. Enter places the highlighted one, Escape closes the picker.
• Type {{ where you want the variable to go. This opens the same list in place, which is quicker once you know what you are looking for. It does not fire in the middle of a word, so use the button if the text right before the cursor is not a space.

A placed variable shows as a labeled chip rather than as raw braces, so you can read a clause and see what it will say. The picker names each variable exactly as the list below does, and tells you what it needs before it can be filled in. That last part is the part worth reading: placing a variable whose step is not in the workflow template is what makes the signing step refuse to save.

Always available. These need nothing from the workflow template.

• Organization name
• Organization address
• Signatory name
• Signatory title
• Signatory email
• Signatory phone
• Date prepared (UTC) (the date the applicant’s document was prepared for signing, printed as 2026-03-14 (UTC). Not the date you wrote the document, and not the date the applicant signs.)
• Verification session ID
• Envelope ID (the reference for this one signing session)

Needs a collect details step in the workflow. These come from the Identity information step, so that step has to be in the workflow template with the matching field switched on.

• Applicant legal name
• Applicant email
• Applicant phone
• Applicant date of birth
• Applicant address

Needs an ID check in the workflow. These are read off the document the applicant photographs, so the workflow template needs an Identity verification step before the signing step.

• ID document type
• ID document country
• ID document number (last 4)
• ID document number (full)

Two rules worth knowing before you write a clause around one:

• A variable a workflow cannot supply blocks the save, not the applicant. If your document quotes the applicant’s address and the workflow template does not collect an address, the workflow will not save and the console names the variable. You never find out by handing an applicant a document with a hole in it.
• The full ID document number is off by default. Use ID document number (last 4) unless you have a specific reason not to. Turning the full number on is a separate, recorded decision that only an Owner or Admin can make, because it puts a complete government identifier into a document that gets emailed.

Add the step to a workflow

Open the workflow template, switch on Document signing, and choose a published version. The step’s settings are covered in Choose the right check types: the read-through requirement, a minimum signer age, and who gets emailed a copy.

The applicant’s side of it, step by step, is in What the applicant sees.

After it is signed

The signed PDF and its certificate of completion are attached to the applicant’s record, and a copy is emailed to whoever you chose. The certificate records who signed, when, from what kind of device, which version of the electronic-records notice they agreed to, and the retention window that applies.

Anyone holding the PDF can check it independently, with no account and no API key, using the hash of the file. The steps are published at Electronic signatures, and the address of that page is printed inside every certificate.

An applicant can also decline. A decline is a recorded outcome with a reason, not an error, and the verification ends there.

How long a signed document is kept

Signed documents and their audit trail are kept for the window set on the workflow template that produced them: Signed document retention, in the Data & privacy section of the workflow editor. The range is 30 days to 2555 days (7 years), the default is the full 7 years, and it is the same on every plan. E-signature is not a plan-gated capability, so no plan shortens how long your signed agreements are kept.

Two rules the editor enforces:

• It can never be shorter than the Data retention window above it. Signed documents outlive the identity evidence collected alongside them, not the other way around.
• Lowering it applies to verifications created afterward, never to documents already signed. An executed agreement keeps exactly the window its own certificate printed.

Deleting a signed agreement early destroys the evidence the signature exists to provide, which is why the default sits at the ceiling. A deletion request from an applicant still outranks the window, as it does everywhere else.

Troubleshooting

• The workflow will not save and names a variable. The document uses a variable the workflow template cannot supply. Either switch on the matching field in the Identity information step, add an Identity verification step, or remove the variable from the document and publish a new version.
• Document signing will not turn on. The workflow template has no Identity information step yet. Add one and place it before the signing step.
• The version picker is empty. The document has drafts but no published version. Open it and select Publish version.
• The step is on but no document is chosen. A signing step with no document cannot be saved. Pick a published version, or switch the step off.
• A signatory is required. Set one under Settings → Organization → Authorized signatory. If you do not have permission, an Owner or Admin in your organization does.
• The verification is waiting for funds. Signing steps are paid checks, so a wallet with no spendable balance pauses the verification instead of skipping the step. Fund the wallet and the applicant carries on from where they stopped. A signature already recorded is safe. See Payment required.