Managing Collections

Creating and Managing Collections

Creating a Collection

1. Go to Collections in the sidebar
2. Click Add Collection
3. Enter:
   • Name — Plural form (e.g., "Products")
   • Singular Name — Single form (e.g., "Product")
   • Description — What this collection stores
4. Click Create

Adding Fields

1. Open your collection
2. Click Fields tab
3. Click Add Field
4. Choose the field type and configure options
5. Click Save Field

Field Types

Type	Use For
Text	Titles, names, short text
Rich Text	Blog content, descriptions with formatting
Image	Photos, thumbnails, hero images
Number	Prices, quantities, ratings
Date	Event dates, publication dates
Boolean	Featured flags, visibility toggles
Select	Categories, status options
Relation	Link to authors, categories, etc.
Video Embed	YouTube, Vimeo URLs

Editing a Collection

Click the collection name, then Settings to modify its name, description, or fields.

Deleting a Collection

In collection settings, scroll to the bottom and click Delete Collection. This removes all items in the collection.

---

Field Types Reference

When creating or editing collections, you can add fields of these types:

Text

Use for: Titles, names, short text, slugs, tags

In templates: {{fieldName}}

Examples: Post titles, author names, product SKUs, categories

<h1>{{name}}</h1>
<span class="category">{{category}}</span>

Rich Text

Use for: Long-form content with formatting (paragraphs, headings, lists, links)

In templates: {{{fieldName}}} (triple braces!)

Important: Always use triple braces to render HTML. Double braces will escape the HTML and show raw tags.

<!-- CORRECT - renders HTML -->
<div class="content">{{{content}}}</div>

<!-- WRONG - shows raw HTML tags -->
<div class="content">{{content}}</div>

Image

Use for: Photos, graphics, thumbnails

In templates: {{fieldName}} returns the image URL

Examples: Featured images, profile photos, product images

<img src="{{featuredImage}}" alt="{{name}}">
<div style="background-image: url('{{photo}}')"></div>

Number

Use for: Prices, quantities, ratings, order numbers

In templates: {{fieldName}}

Note: Supports both integers and decimals

<span class="price">${{price}}</span>
<span class="rating">{{rating}}/5</span>

Date

Use for: Publication dates, event dates, deadlines

In templates: {{fieldName}}

Format: Returns ISO date string - use JavaScript or CSS to format for display

<time datetime="{{publishedAt}}">{{publishedAt}}</time>

Boolean

Use for: Yes/no toggles, feature flags, visibility controls

In templates: Use with {{#if}} conditionals

Examples: "Is featured?", "Show on homepage?", "Is active?"

{{#if isFeatured}}
  <span class="badge">Featured</span>
{{/if}}

{{#if showOnHomepage}}
  <!-- content -->
{{/if}}

Select

Use for: Dropdown choices, categories, status options

Configuration: Define the available options when creating the field

In templates: {{fieldName}} returns the selected option value

<!-- Display the selected value -->
<span class="status status-{{status}}">{{status}}</span>

<!-- Conditional based on value -->
{{#if (eq status "published")}}
  <span class="badge-green">Live</span>
{{/if}}

URL

Use for: External links, social media profiles, website URLs

In templates: {{fieldName}}

<a href="{{websiteUrl}}" target="_blank">Visit Website</a>
<a href="{{twitter}}">Twitter</a>

Email

Use for: Contact emails, author emails

In templates: {{fieldName}}

<a href="mailto:{{email}}">{{email}}</a>

File

Use for: PDFs, documents, downloadable files

In templates: {{fieldName}} returns the file URL

<a href="{{downloadFile}}" download>Download PDF</a>

Video Embed

Use for: YouTube or Vimeo video embeds

In templates: {{{fieldName}}} (triple braces to render iframe)

<div class="video-container">
  {{{videoEmbed}}}
</div>

---

Relation Fields (Linking Collections)

Relation fields connect items between collections. For example, linking a blog post to its author.

Setting Up a Relation Field

1. Go to the collection that needs the link (e.g., Blog Posts)
2. Add a new field with type Relation
3. Choose the Reference Collection (e.g., Authors)
4. Save the field

The Key Rule

Relation fields store the item ID (UUID), not the item name.

When adding or editing content:

• The dashboard shows a dropdown of available items from the referenced collection
• Via API, you must provide the item's UUID, not its name

Using Relations in Templates

Access the related item's fields using dot notation:

<!-- Post has an "author" relation field -->
<article>
  <h1>{{name}}</h1>

  <!-- Access author fields with dot notation -->
  <p class="byline">By {{author.name}}</p>
  <img src="{{author.photo}}" alt="{{author.name}}">
  <p class="bio">{{author.bio}}</p>
</article>

Common Relation Patterns

Blog Post → Author

{{#if author}}
  <div class="author-card">
    <img src="{{author.photo}}">
    <span>{{author.name}}</span>
  </div>
{{/if}}

Product → Category

<a href="/categories/{{category.slug}}">
  {{category.name}}
</a>

Event → Venue

<p>Location: {{venue.name}}</p>
<p>Address: {{venue.address}}</p>

Checking if Relation Exists

Always wrap relation field access in an {{#if}} block in case it's empty:

{{#if author}}
  <p>By {{author.name}}</p>
{{else}}
  <p>By Anonymous</p>
{{/if}}

---

Field Configuration Tips

• Required fields: Mark essential fields as required to prevent incomplete content
• Default values: Set defaults for fields that usually have the same value
• Field descriptions: Add helpful descriptions so content editors know what to enter
• Field order: Drag to reorder fields - put most important fields first

Related Docs

• Managing Content Items — Adding and editing content
• Template Syntax — Using fields in templates
• MCP Server Reference — Creating fields via AI