Custom content with Objects

The Objects module lets you model content that isn't a product: services, bookings, projects, team members, landing pages, anything your storefront needs. You define an object type (the model: its name and its properties), then create records of that type (the actual entries). Each type gets its own entry in the sidebar under Content → Objects, listed by its plural name, and your storefront can read the records through the Objects API.

Objects appears in the sidebar under the Content group when the module is enabled for the active business. Every member of the business sees the same screens and actions.

Create an object type#

1. Open Content → Objects in the sidebar.
2. Click New type. A dialog titled New object type opens with a single name field (placeholder: Name (e.g. Service)). The Create button stays disabled until you type a name.
3. Click Create. You land directly on the new type's builder page, where you define its properties.

The Objects index lists all your types in a table:

The gear icon at the end of each row opens the type builder.

Edit a type in the type builder#

The type builder is where you shape a type after creating it. Open it from the gear icon on the Objects index, or via the Type button on the type's records list. From the builder, View records takes you the other way, to the records list.

You can edit the type's Name and Plural name and click Save (a brief "Saved." confirms). The key cannot be changed; the builder shows Key: {key} (cannot change).

Add a property#

1. Click Add property.
2. Fill in the Label (placeholder: Label (e.g. Budget)). The Key field auto-fills from the label as you type, until you edit the key yourself.
3. Pick a Type (see the table below) and fill any type-specific fields.
4. Optionally tick Required.
5. Click Add. The button stays disabled until both Label and Key are filled.

Property keys, like type keys, are permanent once created.

Sections properties#

A Sections property turns part of a record into a small page builder. When adding one, the dialog asks Which sections can this page use? with a checkbox list of section shapes; you must pick at least one. You also set Minimum (0-100) and Maximum (1-100) item counts; the maximum must be greater than or equal to the minimum.

Section shapes themselves are not managed on these screens. If none exist yet, the dialog says No section shapes exist yet. Create one before adding a sections property.

Sections properties never appear as columns in the records list.

The built-in name property#

Every type has a name property. It cannot be archived, and its required flag cannot be toggled; when required it simply shows a required badge. The record's name is used as its title on the detail page and renders bold in the records list.

Reorder, require, and archive properties#

• Reorder properties with the drag handle (grip icon) or the per-row up/down arrows. The change applies immediately and reverts if it fails to save.
• Required is an inline checkbox on each property row.
• Archive a property with the per-row archive icon. Archiving is reversible: the property disappears from forms and list columns, but the data it holds on existing records is preserved. Archived properties appear in an Archived section of the builder, from which you can unarchive them with the restore icon. Properties are never hard-deleted individually.

Delete a type#

Click Delete type in the builder. The confirmation reads: Delete "{plural name}" and its {count} record(s)? This cannot be undone. Unlike archiving a property, deleting a type is permanent and removes all its records with it.

Work with records#

Click a type on the Objects index (or its sidebar entry) to open its records list. Columns are generated from the type's active properties (Sections properties excluded), with empty values shown as -.

From the list you can:

• Search the table.
• Filter using the auto-generated filters: a dropdown per Select property (with that property's options) and a date-range filter per Date property.
• Sort on any column except Long text and Customer properties.
• Bulk delete: select rows with the checkboxes, then use the bulk Delete action (asks for confirmation).
• Click New {type name} to create a record, or click any row to open the record.

Create a record#

1. Click New {type name} on the records list.
2. Fill the form. It is generated from the type's properties; required fields show a red asterisk. Notable inputs:
   • Money: type the amount with a dot for decimals, e.g. 4950.00. Invalid input blocks submission with Invalid price "{price}". Use a dot for decimals: 4950.00.
   • Select: a dropdown with a Choose... placeholder, plus a None option when the property is not required.
   • Customer: search-as-you-type (minimum 2 characters), showing name and email; click Change to pick a different customer.
   • Sections: a section canvas. Click Add section to open the Add a section picker of shape and look tiles; reorder sections by dragging or with the arrow buttons; duplicate, delete, or hide/show each section; expand a section card to edit its fields. When more than one content locale is enabled, a locale switcher lets you edit each language's content.
3. Click Create. On success you land on the new record's detail page. Validation errors from a failed save appear under the fields concerned; an invalid section gets a Has an error badge and expands automatically.

Edit or delete a record#

The record detail page shows the same generated form. Edit any field and click Save (a brief "Saved." confirms). Delete asks: Delete "{title}"? This cannot be undone.

If archived properties still hold a value on the record, they are listed read-only in an Archived properties panel (archived Sections properties are not shown).

Import and export records#

Each records list has Export CSV and Import CSV buttons. Export downloads the list as a CSV file named after the type's key. Import opens a dialog titled Import {plural name}: upload one .csv file with a header row. Rows are processed independently: valid rows import even when others fail, and the result shows counts of created, updated, and failed rows plus an error per failed row number. The list refreshes after a successful import.