How content types work
A content type brings together three things:- A layout component — defines the overall structure and editable properties (title, subtitle, hero image, etc.)
- Allowed components — the view components that can be added as blocks within the content
- A package version — locks components to a specific version for consistency
Create a content type
Navigate to Types in your project sidebar and click New Content Type.1
Name and describe
Enter a name (e.g., “Article”, “Product Page”) and a description that helps content teams understand when to use this type.
2
Select a layout component
Choose from your available layout components. The layout determines what properties appear in the content builder and how the content renders.
3
Configure allowed components
Add the view components that content teams can use as blocks. You can organize components into groups if your layout has multiple content areas.
Select a layout component
The layout component is the foundation of your content type. It defines:- Properties — the fields content teams fill in (title, author, publish date)
- Structure — how those properties and component blocks are arranged
- Rendering — how the final content looks on screen
Configure allowed components
Allowed components are the building blocks content teams can add when creating content. Click Add Components to open the component browser, search or filter, and select the components you want to allow.Component groups
If your layout has multiple content areas — like a main body and a sidebar — you can organize allowed components into groups. Each group corresponds to a property in your layout component that accepts child components. For example, an FAQ layout might have separate groups for “Questions” and “Answers”, each with different allowed components.Package versions
Content types reference a specific package version. This ensures content always renders consistently, even as you develop new components. During development: Use the draft package to access your latest component changes. For production: Select a published package version. Content types using the draft package can’t be published. To change the package version, click the version indicator and select from available versions.Publish content types
Content types follow a draft-first workflow, similar to content.| Status | Meaning |
|---|---|
| Draft | New type, never published. Can be edited freely. |
| Published | Live and available for creating content. |
| Modified | Published before, but has unpublished changes. |
Edit a published type
To change a published content type:- Make your changes — the status becomes “Modified”
- Click Publish to apply changes
- Existing content continues to work; new content uses the updated type
Content type and content relationship
When content is created, it’s linked to a specific content type version. This means:- Content renders consistently even if you update the content type later
- You control when to migrate existing content to a new type version
- Breaking changes don’t break existing published content
