> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onlyform.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Form settings

> Every supported form behavior setting and its plan availability.

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

```json theme={null}
{
  "utm": {
    "campaign": true,
    "content": false,
    "medium": true,
    "source": true,
    "term": false
  }
}
```

## Cover settings

```json theme={null}
{
  "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

```json theme={null}
{
  "definition": {
    "settings": {
      "closeAt": "2026-12-31T23:59:59Z",
      "closedMessage": "This registration period has ended."
    }
  }
}
```