definition.settings. Supplied keys merge with existing settings. The top-level form type controls single-page versus multi-step presentation.
| Setting | Type | Default | Description | Plan |
|---|---|---|---|---|
branding | boolean | true | Show Onlyform branding. Setting false requires Pro. | Free to show / Pro to remove |
navigation | boolean | true | Show previous/next navigation. | Free |
progressBar | boolean | true | Show progress. | Free |
showTitle | boolean | — | Show the form title. | Free |
singlePage | boolean | derived | Read-only compatibility value. Use top-level type. | Free |
inlineFields | boolean | false | Use compact inline fields where supported. | Free |
borderRadius | number | 0 | Form-level radius override in pixels. | Free |
numberedQuestions | boolean | false | Prefix questions with their position. | Free |
responseLimit | integer | -1 | Maximum responses; -1 means unlimited. Plan limits still apply. | Plan-dependent |
darkMode | boolean | false | Start in dark mode. | Free |
closed | boolean | false | Close the form immediately. | Free |
closeAt | date-time or null | — | Automatically close at an ISO 8601 time. | Free |
closedMessage | string | — | Message displayed when closed. | Free |
duplicateField | block ID or null | — | Reject duplicate submissions using the selected answer field. | Free |
redirectUrl | URL | — | Redirect after completion. | Pro |
submitLabel | string | — | Custom submit button label. | Free |
cover | object | — | Single-page cover color, image, and focal position. | Free |
utm | object | all false | Capture selected UTM parameters. | Free |
UTM settings
{
"utm": {
"campaign": true,
"content": false,
"medium": true,
"source": true,
"term": false
}
}
Cover settings
{
"cover": {
"color": "#E8EEFC",
"image": {
"url": "https://cdn.example.com/cover.jpg",
"width": 1600,
"height": 900
},
"position": { "x": 50, "y": 40 }
}
}
Closed form with a scheduled time
{
"definition": {
"settings": {
"closeAt": "2026-12-31T23:59:59Z",
"closedMessage": "This registration period has ended."
}
}
}