Creating Content Types

A Content Type (also called a Content Model) defines the fields available when editing a page or component. You create one whenever you need a new kind of page layout or a new component type that isn’t covered by the built-in models.

Creating a component content type

Use this when you want a new reusable block — e.g. a TestimonialCard, PricingTable, or VideoEmbed.

1. Open Content Models

   In the sidebar, click Content Models.

2. Create a new model

   Click New Content Model. Fill in:

   Field	Value
   Name	Human-readable label, e.g. Testimonial Card
   API ID	PascalCase identifier, e.g. TestimonialCard
   Type	Component

   Note

   The API ID is permanent and must match the key used in your storefront’s RenderCmsContent component map. Choose it carefully.

3. Add fields

   Click Add Field for each piece of data the component needs:

   Field name	Type	Notes
   quote	richtext	The testimonial body
   author	text	Author name
   role	text	Author role/company
   avatar	image	Author photo

4. Save

   Click Save. The content type is now available when adding components to any page in this space.

Creating a page content type

Use this when you need a new page layout with different zones — e.g. a LandingPage with a hero zone and a content zone.

1. Create a new model with Type set to Page.

2. Add zones using the components field type. Each zone becomes a slot editors can fill:

   Field name: heroZone     → Type: components
   Field name: contentZone  → Type: components
   Field name: footerZone   → Type: components

3. Save. The new page type appears in the New Page dialog.

Field types reference

Type	Description	Example use
text	Single-line string	Title, label
textarea	Multi-line plain text	Short description
richtext	Formatted text (Tiptap)	Body copy
number	Integer or decimal	Limit, count, price
boolean	True/false	isHighlighted, showBorder
select	Dropdown with fixed options	Layout variant (left, right, center)
color	Hex color picker	Background color
image	Image asset from Media	Hero image, avatar
button	Label + URL + variant	CTA button
components	Nested component slot	Container, grid children

Editing and duplicating models

• Edit fields — click the model name to open its field editor. You can add, reorder, or remove fields at any time.
• Duplicate — use the ⋯ menu → Duplicate to copy a model. Useful for creating layout variants.
• Delete — only possible if no content entries use this model.

Caution

Removing a field from a content model does not delete existing data for that field — it simply stops appearing in the editor. The data is still returned by the delivery API until those content entries are re-published.

Using the CLI

Content models can also be created and imported programmatically. See the CLI reference for details.