Content Type Builder#

Creating a Content Type#

1. On the Content Types list, click Create Content Type.
2. In the dialog, fill in:
   • Display Name (required) - the human-readable name, e.g. "Blog Post".
   • Singular Name and Plural Name - auto-filled from the Display Name as you type (e.g. "Blog Post" -> blogPost / blogPosts). You can edit either one by hand; once you do, that box stops auto-filling.
   • API Identifier - a read-only preview of the technical name the CMS API will use for this content type. It is generated from the Plural Name for a Collection, or the Singular Name for a Single type (falling back to the Display Name if left blank). It cannot be edited directly and is fixed permanently once the content type is created.
   • Type - choose Collection, Single, or Component.
   • Description - an optional description of the content type.
3. Click Create.

The content type is created and you return to the Content Types list. To add fields, open the new content type.

Note: Choose the Singular/Plural Name carefully before creating - they determine the permanent API Identifier and cannot be changed afterward (see Editing Content Type Information below).

Opening a Content Type to Edit It#

On the Content Types list, click the card for the content type you want. This opens the builder page for that content type, with two sections:

• Content Type Information - the content type's details.
• Fields - the list of fields, with options to add, edit, and delete them.

Editing Content Type Information#

In the Content Type Information section you can edit:

• Display Name (required) - the human-readable name.
• Category - an optional grouping label, e.g. "blog" or "pages".
• Icon (Iconify name) - an optional icon name.
• Description - an optional description.

The following are shown but locked once the content type exists, because they determine the public API path (/api/public/cms/:contentType) that this content type is served under:

• Singular Name and Plural Name - fixed at the values set when the content type was created.
• Type - Collection, Single, or Component.
• API Identifier - a read-only field showing the technical name in use.

Click Save (top right) to save your changes.

Adding a Field#

Fields can only be added once the content type has been created and you are editing it.

1. Open the content type from the Content Types list.
2. In the Fields section, click Add Field.
3. Fill in:
   • Display Name (required) - the field's label, e.g. "Title" or "Author Name".
   • API Name - the technical name. It auto-fills from the Display Name as you type (e.g. "Profile Picture" -> profilePicture). Edit it by hand to override; once you do, it stops auto-filling.
   • Field Type - choose the kind of data the field holds (see Field Types below).
   • Required - tick this if the field must always be filled in.
4. Click Add.

Reordering Fields#

In the Fields section, drag a field by the grip handle (⠿) on the left of its row to move it up or down the list. The new order is saved automatically. The grip handle can also be operated from the keyboard: focus it and press Space to pick up the field, use the arrow keys to move it, and press Space again to drop it in place.

Editing a Field#

1. Open the content type.
2. In the Fields section, click the edit (pencil) icon on the field.
3. You can change the Display Name and the Required setting. The API Name and Field Type cannot be changed after a field is created.
4. Click Update.

Deleting a Field#

1. Open the content type.
2. In the Fields section, click the delete (trash) icon on the field.
3. Confirm by clicking Delete in the confirmation dialog.

Warning: Deleting a field cannot be undone. If you later add a new field with the same API Name, it is treated as a fresh field with a clean, empty setup rather than restoring what was deleted.

Deleting a Content Type#

1. Open the content type you want to remove.
2. Click Delete (top right, next to Save).
3. A confirmation dialog shows how many fields - and, if any exist, how many entries - will be removed along with the content type, and warns that its public API path will stop responding.
4. Click Delete to confirm.

Warning: Deleting a content type also removes all of its fields and entries, and cannot be undone. If you later create a new content type with the same name, it reuses the deleted one starting from a clean schema - it does not restore the old fields or entries.