Forms

A form is a reusable template. This page covers a form's overall shape; the pages below cover each part.

Field Types & Validation — every field type, its properties, validations, and static prefill.
Signers — map answers to signers, add known signers, and define signer slots.
Conditional Fields & Sections — show or hide fields based on earlier answers.
Merge Fields — reference earlier answers inside HTML and titles.
Form Options — case file title, redirects, signing methods, email, and language.
Managing Forms — the DRAFT → ACTIVE → ARCHIVED lifecycle.

Anatomy of a form

{
  "name": "Employee Onboarding",
  "language": "EN",
  "description": "New employee information",
  "sections": [
    {
      "title": "Personal Information",
      "description": "Your basic details",
      "fields": [
        { "type": "TEXT",  "label": "Full Name", "required": true, "mapTo": "primarySigner.name" },
        { "type": "EMAIL", "label": "Email",     "required": true, "mapTo": "primarySigner.email" }
      ]
    }
  ]
}

Property	Type	Description
`name`	string	The form's name. Required, cannot be blank.
`language`	enum	Form language. One of `DA`, `DE`, `EN`, `FI`, `FR`, `NL`, `NO`, `SV`. Defaults to `DA`. Controls notification email language and the signing page's default language.
`description`	string	Optional description shown to respondents.
`sections`	array	The form's sections. At least one is required.

Signers and other options are also set at this level. See Signers and Form Options.

Sections

Each section groups related fields under a title.

Property	Type	Description
`title`	string	The section heading.
`description`	string	Optional text shown under the heading.
`slug`	string	A short, URL-safe identifier for the section. Auto-generated from `title` if you don't set one. Used as the key when creating a prefilled request.
`fields`	array	The section's fields. See Field Types & Validation.
`condition`	object	Optional visibility rule. See Conditional Fields & Sections.
`multipleEntries`	object	Optional. Makes the section repeatable — see below.

Multi-entry sections

Set multipleEntries on a section to let a respondent add several instances of it (for example, one block per family member):

{
  "title": "Family Members",
  "multipleEntries": { "max": 5 },
  "fields": [
    { "type": "TEXT", "label": "Name", "required": true }
  ]
}

max must be between 1 and 100. Fields can also be made repeatable on their own. See Field Types & Validation.

Creating and publishing

A form is created in DRAFT and must be published before it accepts submissions. See Managing Forms for the full lifecycle, and Getting Started for an end-to-end walkthrough.