Skip to main content

Documentation

Learn how to use the Headless platform

Content Types

2 min read

Content types define the structure of your content. Think of them as templates.

Creating a Content Type

  1. Navigate to Content Types in your project
  2. Click Create Content Type
  3. Enter a name (e.g., "Blog Post")
  4. The API ID is auto-generated (e.g., blogPost)
  5. Add an optional description
  6. Click Create

Adding Fields

Each content type needs fields to store data:

  1. Click Add Field on your content type
  2. Select a field type (see below)
  3. Configure the field settings
  4. Click Save

Field Types

TypeDescriptionExample Use
TextShort text, single lineTitle, name
Rich TextFormatted text with HTML/MarkdownArticle body, bio
NumberInteger or decimalPrice, quantity
BooleanTrue/false toggleFeatured, active
DateDate only (no time)Birth date, event date
DateTimeDate with timePublish date, timestamp
EmailValidated email addressAuthor email
URLValidated web addressExternal link
SlugURL-friendly identifierPage URL path
SelectSingle choice from optionsCategory, status
Multi-SelectMultiple choicesTags, features
MediaFile upload referenceHero image, documents
ReferenceLink to another entryAuthor, related posts
JSONFlexible JSON dataCustom metadata

Field Settings

Each field can be configured with:

  • Required: Must have a value
  • Unique: No duplicate values allowed
  • Localized: Different values per language (when enabled)
  • Validation: Min/max length, patterns, ranges

Content Type Options

When creating a content type, you can choose:

  • Collection: Multiple entries (e.g., blog posts, products)
  • Single: Only one entry allowed (e.g., homepage, site settings)

Example: Blog Post Content Type

Text
Blog Post (Collection)
├── title (Text, required)
├── slug (Slug, required, unique)
├── content (Rich Text, required)
├── excerpt (Text, max 200 chars)
├── featuredImage (Media)
├── author (Reference → Author)
├── publishedAt (DateTime)
├── tags (Multi-Select)
└── featured (Boolean)

Example: Site Settings (Singleton)

Text
Site Settings (Single)
├── siteName (Text, required)
├── tagline (Text)
├── logo (Media)
├── socialLinks (JSON)
└── maintenanceMode (Boolean)

Editing Content Types

  1. Navigate to Content Types
  2. Click on the content type you want to edit
  3. Add, remove, or modify fields as needed
  4. Click Save

Note: Some changes (like removing fields) may affect existing content entries.

Deleting Content Types

Warning: This will delete all entries of this type.

  1. Navigate to Content Types
  2. Click the menu icon (⋮) on the content type
  3. Select Delete
  4. Confirm the deletion