Add a New Collection to Your CMS

Once your CMS is initialized, you’ll add collections as your site grows. Maybe you started with just a blog and now you need case studies, team members, or product listings. There are three paths — pick whichever matches the situation.

Easiest

Ask the AI

Visual

Collection Manager UI

For developers

Edit hiveku.cms.json

Option 1: Ask the AI

The fastest way for most additions, especially when you have a clear idea of the fields.

Open your project in /v3

From the dashboard, open the project.

Open the AI chat

Click the AI tab in the left panel.

Describe the collection you want

Be specific about purpose and fields. The more detail, the less back-and-forth.

Add a "case-studies" collection with title, client name, industry,
summary (short), hero image, and a long-form body. Route them at
/case-studies/{slug}.

Or, if you’re less sure:

I need a collection for our team page. Each team member has a name,
title, photo, short bio, and links to their socials.

Review the proposed schema

The AI returns a manifest entry — collection ID, fields, route pattern, default sort. Approve or revise:

“Make industry a select with options: SaaS, Healthcare, Finance, Other”
“Add a featured boolean so we can promote a few”
“Use field-based slugs from the title instead of filename”

Approve and save

Once you’re happy, the AI updates hiveku.cms.json, creates the directory under content/, and (optionally) seeds it with one example entry.

Verify in the CMS panel

Switch the right pane to CMS mode. The collection picker now lists your new collection. Click it — the entry list and form are ready to use.

Ask the AI to also wire up the page that renders this collection: “After adding the case-studies collection, create app/case-studies/page.tsx (list view) and app/case-studies/[slug]/page.tsx (detail view) reading from the CMS.”

Option 2: Collection Manager UI

Use this when you want a visual builder and immediate validation feedback.

Open the CMS panel

In /v3, switch the right pane to CMS mode.

Open Collection Manager

Click the gear icon at the top of the panel — it’s next to the collection picker.

Click + New Collection

A form appears with the collection’s top-level properties:

ID — case-studies (lowercase, hyphenated, must be unique)
Display name — Case Studies
Path — content/case-studies (auto-filled from ID)
Format — MDX (with body) or JSON (structured only)
Slug from — Filename or a specific field
Route pattern — /case-studies/{slug} (optional)

Define the fields

Click + Add Field for each one. For each field:

Name — camelCase identifier
Type — picked from a dropdown (string, number, image, etc.)
Required — toggle
Default — typed if relevant
Type-specific options — like options for select, collection for reference

Drag the rows to reorder them — order in the manifest matches order in the form.

Save

Click Create Collection. The Collection Manager closes, the manifest is updated, and the new collection appears in the picker.

Add your first entry

Click + New Entry in the entry list and start filling in the form.

Option 3: Edit the Manifest Directly

For developers who want full control or are scripting setup.

Open hiveku.cms.json

Switch the right pane to Code and open hiveku.cms.json from the file tree.

Add a new entry to the collections array

Following the manifest schema:

{
  "id": "case-studies",
  "name": "Case Studies",
  "path": "content/case-studies",
  "format": "mdx",
  "slugFrom": "filename",
  "fields": [
    { "name": "title", "type": "string", "required": true },
    { "name": "client", "type": "string", "required": true },
    { "name": "industry", "type": "select", "options": ["SaaS", "Healthcare", "Finance", "Other"] },
    { "name": "summary", "type": "string", "multiline": true, "maxLength": 320 },
    { "name": "heroImage", "type": "image" },
    { "name": "publishedAt", "type": "date" },
    { "name": "body", "type": "markdown", "isBody": true }
  ],
  "routePattern": "/case-studies/{slug}",
  "defaultSort": "publishedAt desc"
}

Drop it inside the existing collections array.

Save the file

Cmd+S / Ctrl+S. The CMS panel reloads and validates the manifest. If anything is wrong (duplicate ID, invalid field type, missing isBody on MDX), you’ll see an error banner.

Create the directory

The CMS panel creates the directory automatically when you save the first entry. If you want it created up front, add an empty .gitkeep file:Right-click content/ → New Folder → case-studies → New File → .gitkeep

Add a sample entry

Either via the CMS panel (click + New Entry) or by creating a file directly. For an MDX collection:Right-click content/case-studies/ → New File → acme-corp.mdx and paste:

---
title: "How Acme Corp doubled conversion"
client: "Acme Corp"
industry: "SaaS"
summary: "We helped Acme rebuild their checkout flow..."
publishedAt: "2026-04-01"
---

The full case study goes here in Markdown.

Verifying

After adding a collection through any path:

Check the collection picker

Open the CMS panel. The new collection should be in the picker.

Open the form for a new entry

Click + New Entry. Every field you defined should render with the right control.

Save a real entry

Fill in the required fields and save. Confirm the file appears in the file tree at the expected path.

Render it

If you set a routePattern, navigate the preview to that URL. If you also asked the AI (or wrote yourself) a page that reads this collection, the entry should render. If not, ask the AI: “Build the list and detail pages for the case-studies collection.”

Troubleshooting

Manifest invalid after edit

The most common cause is a typo or duplicate id. The error banner in the CMS panel points at the offending collection. Fix in the code editor and save.

Slug conflict on save

Two entries with the same slug can’t coexist in one collection. Rename one. If you’re using slugFrom: "field:title", picking a unique title resolves it.

`isBody` set on a JSON collection

Validation rejects this — body fields are only valid on MDX collections. Remove isBody: true from the field, or change the format to mdx.

Two `isBody: true` fields on one MDX collection

Exactly one body field is allowed per MDX collection. Remove isBody: true from one of them.

ID has uppercase or spaces

id must be lowercase, alphanumeric, and hyphenated. Case Studies is invalid; case-studies is correct. Display names can be any string — that’s the name field.

Reference field's collection doesn't exist

A reference field’s collection value must match an existing collection’s id. Add the target collection first, or fix the reference.

The collection appears but the entry list is empty

Expected for a brand-new collection. Click + New Entry to add the first one.

What’s Next?

Field Types

Pick the right type for each field

References

Link collections together

Editing Content

Day-to-day editing in the CMS panel

Migrate to CMS

Pull existing hardcoded content into your new collection

Get Started

AI Assistant

Code Editor

Design Studio

CMS

Email Marketing

Social Media

Advertising

Commerce

Calendar

Communications

Sales

Publishing

Native Mobile

Email

Integrations

How-Tos

Account & Settings

Partners

Add a New Collection to Your CMS

Easiest

Visual

For developers

Option 1: Ask the AI

Option 2: Collection Manager UI

Option 3: Edit the Manifest Directly

Verifying

Troubleshooting

What’s Next?

Field Types

References

Editing Content

Migrate to CMS

Easiest

Visual

For developers

​Option 1: Ask the AI

​Option 2: Collection Manager UI

​Option 3: Edit the Manifest Directly

​Verifying

​Troubleshooting

​What’s Next?

Field Types

References

Editing Content

Migrate to CMS

Option 1: Ask the AI

Option 2: Collection Manager UI

Option 3: Edit the Manifest Directly

Verifying

Troubleshooting

What’s Next?