Concepts
Collections & Singles
Understanding collections, singles, and custom content types
Collections & Singles
Collections and singles are the building blocks of your content structure. Each defines a custom content type with its own fields.
Collections
A collection is a container for multiple related content items - like a database table that defines the schema for a type of content.
Examples:
- Blog Posts - articles with title, content, author
- Products - items with name, price, description
- Team Members - people with name, role, bio
- Events - dates with title, location, description
Singles
A single is a content type that only has one item by design. Use singles for unique pages or global content that shouldn't have multiple entries.
Examples:
- Homepage - hero title, featured content
- About Page - company description, mission
- Site Settings - global configuration
- Contact Info - address, email, phone
Properties
| Property | Description |
|---|---|
| Type | Collection (multiple items) or Single (one item) |
| Name | Display name (e.g., "Blog Posts" or "Homepage") |
| Slug | URL-safe identifier (e.g., "blog-posts") |
| Icon | Icon for the admin UI |
| Default Language | Primary language for content |
| Supported Languages | Languages enabled for this collection |
Field Types
| Type | Description |
|---|---|
| Text | Single line text |
| Textarea | Multi-line text |
| Markdown | Rich text editor |
| Number | Numeric values |
| Date | Date picker |
| DateTime | Date and time |
| Boolean | Toggle/checkbox |
| Select | Dropdown options |
| List | Array of values |
| Relation | Link to another item |
| Relation List | Links to multiple items |
| Image | Single image (URL or from gallery) |
Translatable vs Non-Translatable
Translatable fields: Content differs per language (titles, descriptions)
Non-translatable fields: Same value across languages (SKU, price, dates)
Built-in Fields
Every item includes:
id- Unique identifierslug- URL-safe string (fixed to "main" for singles)title- Required translatable titleitemDate- Date for sorting (auto-set for singles)createdAt/updatedAt- Timestamps
Collections vs Singles
| Feature | Collections | Singles |
|---|---|---|
| Number of items | Multiple | One |
| Slug field | User-defined | Fixed to "main" |
| Date field | User-defined | Auto-set |
| Sidebar link | Opens item list | Opens edit form directly |
| Use case | Blog posts, products | Homepage, settings |