Skip to main content
Content types define what kinds of content your team can create. An “Article” type, a “Product Page” type, a “FAQ” type — each has its own structure, its own layout, and its own set of allowed components. When content teams create new content, they pick a content type. That choice determines what fields they fill in and what components they can use.

How content types work

A content type brings together three things:
  1. A layout component — defines the overall structure and editable properties (title, subtitle, hero image, etc.)
  2. Allowed components — the view components that can be added as blocks within the content
  3. A package version — locks components to a specific version for consistency
This combination creates a controlled environment where content teams have flexibility to build, but within guardrails you define.

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
To change the layout, click the current layout in the editor and select a different one. Only layout components appear in the picker.

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.
You can’t publish a content type that uses the draft package version. Publish your components as a package first, then update the content type to use that version.

Publish content types

Content types follow a draft-first workflow, similar to content.
StatusMeaning
DraftNew type, never published. Can be edited freely.
PublishedLive and available for creating content.
ModifiedPublished before, but has unpublished changes.
Click Publish to make your content type available. Content teams can then create content using this type.

Edit a published type

To change a published content type:
  1. Make your changes — the status becomes “Modified”
  2. Click Publish to apply changes
  3. 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

What’s next