Add Form
Set up the form for creating new records.
Go to Areas → General, click the gear icon on a collection, then select the Forms tab.
Configuration cards
The add form has these configuration cards:
| Card | Description |
|---|---|
| Display Settings | Turn on to customize the appearance of the add form container. |
| Customize Add Form Fields | Turn on to control field visibility, layout, and default values. |
| Include Related Models | Turn on to enable related models for the add form data. |
Display settings
Display settings control the add 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 an initial value for new records. The button reads Edit once a default exists. |
| Form Required | Whether the field must have a value before the record can be saved. |
| Visible | Whether the field appears in the form. |
| 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.
Default value configuration
Click the Set (or Edit) button in the Fields Configuration table to define how a field is pre-filled when creating new records.
Static default value
Enter a specific value directly into the Default Value input field. This value applies to every new record.
Populate from logged-in user
Turn on Populate From Logged In User to dynamically fill the field based on the current user's session data.
- Open the Select Auth Collection dropdown and choose the collection representing the logged-in user.
- Open the Select Session Field dropdown and map a field from the user's session to the collection field.
This is commonly used for fields like createdBy or ownerId.
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.