Skip to main content

betaThis is a new capability. Help us improve it and give your feedback on Slack.

form-definition-v2-schema

Form Definition V2 Schema Type

object (Form Definition V2 Schema)

Form Definition V2 Schema Properties

PropertyTypeRequiredNullableDefined by
enginestringOptionalcannot be nullForm Definition V2 Schema
namestringOptionalcannot be nullForm Definition V2 Schema
feedbackobjectOptionalcannot be nullForm Definition V2 Schema
startPagestringOptionalcannot be nullForm Definition V2 Schema
metadataobjectOptionalcannot be nullForm Definition V2 Schema
declarationstringOptionalcannot be nullForm Definition V2 Schema
skipSummaryMultipleOptionalcan be nullForm Definition V2 Schema
phaseBannerobjectOptionalcannot be nullForm Definition V2 Schema
optionsobjectOptionalcannot be nullForm Definition V2 Schema
outputEmailstringOptionalcannot be nullForm Definition V2 Schema
outputobjectOptionalcannot be nullForm Definition V2 Schema
outputsarrayOptionalcannot be nullForm Definition V2 Schema
schemaNot specifiedOptionalcannot be nullForm Definition V2 Schema
pagesarrayRequiredcannot be nullForm Definition V2 Schema
listsarrayOptionalcannot be nullForm Definition V2 Schema
conditionsarrayOptionalcannot be nullForm Definition V2 Schema
sectionsarrayRequiredcannot be nullForm Definition V2 Schema

engine

Form engine version to use (V1 or V2)

engine

Engine Type

string (Engine)

engine Default Value

The default value is:

"V1"

name

Unique name identifying the form

name

Name Type

string (Name)

feedback

Feedback mechanism configuration

feedback

Feedback Type

object (Feedback)

startPage

Path of the first page to show when starting the form

startPage

Start Page Type

string (Start Page)

metadata

Custom metadata for the form

metadata

Metadata Type

object (Metadata)

declaration

Declaration text shown on the summary page

declaration

Declaration Type

string (Declaration)

skipSummary

option to skip the summary page

skipSummary

Skip Summary Type

any of the following: array or boolean or number or object or string (Skip Summary)

phaseBanner

Phase banner configuration

phaseBanner

Phase Banner Type

object (Phase Banner)

options

Options for the form

options

Options Type

object (Options)

outputEmail

Email address where form submissions are sent

outputEmail

Output Email Type

string (Output Email)

outputEmail Constraints

email: the string must be an email address, according to RFC 5322, section 3.4.1

output

Configuration for submission output format

output

Output Type

object (Output)

outputs

One or more email targets/types for submission emails

outputs

Outputs Type

object[] (Outputs Item)

schema

Form schema version to use (2)

schema

Schema Type

unknown (Schema)

schema Constraints

constant: the value of this property must be equal to:

2

pages

Pages schema for V2 forms

pages

Pages Type

object[] (Pages Item)

pages Constraints

unique items: all items in this array must be unique. Duplicates are not allowed.

lists

Lists schema for V2 forms

lists

Lists Type

object[] (Lists Item)

lists Constraints

unique items: all items in this array must be unique. Duplicates are not allowed.

conditions

Named conditions used for form logic

conditions

Conditions Type

object[] (Conditions Item)

conditions Constraints

unique items: all items in this array must be unique. Duplicates are not allowed.

sections

Sections schema for V2 forms

sections

Sections Type

object[] (Sections Item)

sections Constraints

unique items: all items in this array must be unique. Duplicates are not allowed.