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. In the Options field, enter your options as a JSON array.
  5. Click Save.

Options format​

For select type Data Objects, provide a JSON array of objects with value and label properties:

[
  { "value": "pending", "label": "Pending" },
  { "value": "approved", "label": "Approved" },
  { "value": "rejected", "label": "Rejected" }
]
PropertyTypeDescription
valuestringThe stored value (used in backend logic)
labelstringThe display text (shown in dropdowns)

Click Format to auto-format your JSON for readability.

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.