7.1.1 Beginner Tutorials — Create Your First CMS Type

This tutorial explains how to define a basic CMS content type that can be used to create, manage, and publish structured content. It emphasizes simplicity, validation, and best practices suitable for a first-time setup.

Step 1: Open the CMS Builder

Access the CMS Builder from the main navigation. Only users with content model permissions can create or modify content types.

Step 2: Create a Content Type

Create a new content type and define its identity.

Required properties:

Display name

Unique slug

Optional description

The slug is used in APIs and routing and should be stable.

Step 3: Add Fields

Define the fields that describe your content structure.

Common field types:

Text and rich text

Numbers and booleans

Media references

Relations to other content types

Field order determines how the editor renders the form.

Step 4: Configure Validation

Each field can define validation rules.

Validation options:

Required or optional

Length or value limits

Relation constraints

Validation ensures consistent data entry.

Step 5: Enable Localization

If your project is multilingual, enable localization for the content type and select which fields are translatable.

Localization behavior:

One entry per locale

Shared non-translatable fields

Predictable fallback rules

Step 6: Save and Review

Save the content type. The system validates the schema and prevents destructive changes when data exists.

Step 7: Create Your First Entry

Create an entry using the content editor. New entries start in draft state by default.

Step 8: Publish

Publish the entry to make it available for delivery through public APIs and channels. Publishing actions are logged and reversible.

Best Practices

Keep initial content types simple. Avoid frequent structural changes once content is in use, as changes affect editors, APIs, and integrations.