Collections & Entries

Collections let you manage repeatable, structured data — FAQs, team members, products, and more.

What is a Collection?

A collection is like a Section, but designed for repeatable data. You define the structure once (with elements using the same drag-and-drop Editor interface), then create many Entries that follow that structure.

Common use cases: FAQs, team members, products, testimonials, portfolio items, job listings, event listings, partner logos.

Defining a Collection

Collections are created in the Editor using the same interface as sections — rows, slots, and elements.

Entries

An entry is a single record in a collection. Each entry has:

Only published entries with "shown" visibility are returned by the public API.

Fetching via BreaseContext

For collections needed globally (e.g., in navigation or footer), configure them in BreaseContext:

// src/lib/brease-config.ts
export const contextData = {
  navigations: [],
  collections: [
    { key: 'faqs', id: 'col-a01c8223-4e4a-40aa-90d9-70149e87322c' },
    { key: 'testimonials', id: 'col-b02d9334-5f5b-51bb-a1ea-81250f98433d' },
  ],
}

Then access in client components:

'use client';

import { useBrease } from 'brease-next';

export default function Testimonials() {
  const { collections } = useBrease();
  const { testimonials } = collections;

  if (!testimonials || testimonials.length === 0) return null;

  return (
    <div>
      {testimonials.map(entry => (
        <blockquote key={entry.uuid}>
          <p>{entry.elements.quote as string}</p>
          <cite>{entry.elements.author as string}</cite>
        </blockquote>
      ))}
    </div>
  );
}