Form settings - Onlyform API

Pass settings under 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."
    }
  }
}