Edit Form
Set up the form for updating existing records.
Go to Areas → General, click the gear icon on a collection, then select the Forms tab.
Configuration cards
The edit form has these configuration cards:
| Card | Description |
|---|---|
| Display Settings | Turn on to customize the appearance of the edit form container. |
| Customize Edit Form Fields | Turn on to control field visibility and editability. |
| Include Related Models | Turn on to enable related models for the edit form data. |
| Apply Scope | Control who can edit records and when. See Apply Scope for details. |
Display settings
Display settings control the edit form's appearance:
| Setting | Description |
|---|---|
| Display Mode | The layout style for the form. Choose between Drawer, Modal, New Page, or Card. |
| Columns Per Row | The number of fields displayed per horizontal row (1–4). Applies to all display modes, including New Page. |
| Width | The layout width in pixels. Available for Modal and Drawer modes. |
| Drawer Position | The placement of the drawer (Left, Right, Top, or Bottom). Available for Drawer mode. |
| Use Field Icons | Turn on to display field icons in generated forms. |
Fields configuration
The Fields Configuration table lists every field in the collection and its form options. Drag a field's handle to reorder fields directly — there are no separate action buttons.
| Column | Description |
|---|---|
| Field Name | The field identifier. Required fields are marked with a star. |
| Column Span (0-12) | The number of grid columns the field spans. |
| Default Value | Click Set to give the field a value. The button reads Edit once a default exists. |
| Form Required | Whether the field must have a value before changes can be saved. |
| Visible | Whether the field appears in the form. |
| Editable | Whether the field can be changed during updates. Available only when the field is visible. |
| Localization | For a field with Localization enabled, set its Mode — Current language, or All languages (with a Tabs or Stacked layout). |
Fields that are required at the database level have Form Required locked on. After you set a Default Value for one of these fields, you can turn Form Required off and hide the field with Visible, because the default supplies the value.
If a field is required but is not editable and has no default value, a warning appears next to Form Required. The form can't supply a value for the field, so records can't be saved. Set a Default Value or turn on Editable to resolve it.
Apply scope
Define who can edit records and under what conditions. See Apply Scope for full configuration details.
Include related models
Turn on Include Related Models to view, link, or edit records of related collections directly within the form. Configure it on the form's Related Models tab — see Related Models for the full setup.