Skip to main content

Data Object

Data Objects are reusable option sets that can be referenced by Choice fields. Instead of manually entering options for each field, create a Data Object and share it across your project.

Go to Interface → Data Object in the top navigation.

When to use​

  • Consistency — Maintain a single source of truth for dropdown options
  • Efficiency — Update options in one place and changes reflect everywhere
  • Organization — Keep option lists separate from field configuration

Data object list​

The list displays all Data Objects in your project:

ColumnDescription
NameIdentifier for the Data Object
ProjectThe project this Data Object belongs to
Data TypeType of data stored. Supports select.
Action Edit or Delete the Data Object

Creating a data object​

  1. Click Add Data Object.
  2. In the Name field, enter a name for your Data Object (for example, orderStatuses, paymentMethods).
  3. Open the Data Type dropdown and select select.
  4. Add each option under Options (see Adding options).
  5. Click Save.

Adding options​

Under Add Option, build each option and click Add. Options accumulate in the Preview pane.

FieldDescription
LabelThe display text shown in dropdowns.
ValueThe stored value used in backend logic.
Color & IconExpand to set the option's color (a preset swatch or a custom color) and icon.

To add many options at once, expand Import from JSON and paste a JSON array of objects. Each object requires value and label properties. You can optionally include color (a hex color string) and icon (a Lucide icon name):

[
  { "value": "pending", "label": "Pending", "color": "#f59e0b", "icon": "Clock" },
  { "value": "approved", "label": "Approved", "color": "#10b981", "icon": "CheckCircle" },
  { "value": "rejected", "label": "Rejected", "color": "#ef4444", "icon": "XCircle" }
]

These render as Pending Approved Rejected.

Using data objects in fields​

  1. Go to Collections → select your collection → Fields.
  2. Add or edit a Choice field.
  3. Turn on Use Data Object.
  4. Select your Data Object from the dropdown.

The field pulls its options from the Data Object instead of using manually entered values.

Editing a data object​

  1. Click the Edit button next to the Data Object.
  2. Update the name, data type, or options.
  3. Click Save.
note

Changes to a Data Object immediately affect all fields that reference it. Review dependent fields before making updates.

Deleting a data object​

  1. Click the Delete button next to the Data Object.
  2. Confirm the deletion.
warning

Deleting a Data Object will break any Choice fields that reference it. Update those fields to use manual options or a different Data Object before deleting.