Skip to main content
Form fields are regular content elements with type: "formField". They render as interactive AcroForm widgets in PDF and as printable controls in other formats.

Element shape

Properties

Validation rules

  • select fields require at least one option.
  • Option labels must be unique.
  • selectionMode and selectedOptions apply only to checkbox fields.
  • A single-select checkbox accepts at most one selected option.
  • Every selected option must exist in options.
  • Number fields require numeric values; checkbox scalar values must be boolean.
  • A select value must be one of its options.
  • signerRole is rejected on every field type except signature and initials.

Checkbox group

For single-selection radio-style controls, use selectionMode: "single" and checkboxShape: "circle".

Form field in a table cell

A table cell may contain text, an image, or one form field, but not more than one of these at the same time.

Global defaults

Use defaults.styles.formField for visual defaults and defaults.spacing.before.formField / defaults.spacing.after.formField for vertical spacing. Local style and spacing values take precedence.
Signature and initials fields are AcroForm widgets, not cryptographic or PAdES signatures.