Skip to main content

Section–Collection Matrix

Most sections store content directly -- you edit it in the visual editor. Some sections can also pull data from your collections (posts, team members, testimonials, etc.). This page shows which sections support which collections.


Compatibility matrix

SectionData SourceCompatible Collections
Hero SplitInline--
Hero CenteredInline--
Hero MinimalInline--
Features GridInline or Collectionfeatures, capabilities, benefits
Feature ShowcaseInline or Collectionfeatures, services, offerings
Blog GridCollectionposts, articles, news, blog
TeamInline or Collectionteam, staff, members, people, employees, board, volunteers, instructors, providers, agents
TestimonialsInline or Collectiontestimonials, reviews, quotes
PricingInline or Collectionpricing-plans, plans, tiers
FAQInline or Collectionfaqs, questions
StatsInline--
Logo CloudInline or Collectionpartners, clients, logos
CTA BannerInline--
ContactForm--
NavbarGlobal--
FooterGlobal--

Legend:

  • Inline -- Content is edited directly in the visual editor. The section stores its own data.
  • Collection -- The section can be populated automatically from a matching collection.
  • Form -- The section renders a contact form rather than displaying content items.
  • Global -- Navigation sections configured through the Layout Editor, shared across all pages.

How it works

Inline mode (default)

Every section starts in inline mode. You edit content directly in the visual editor -- adding feature cards, testimonial quotes, team members, and so on. Each section stores its own items.

Collection mode

When you use a site template, the template system automatically maps your collections to compatible sections. For example:

  • The Blog template maps the posts collection to the Blog Grid section
  • The About template maps the team collection to the Team section
  • The Landing Page template maps testimonials to the Testimonials section

When a section is connected to a collection, published items appear automatically. You do not need to re-enter the data.

Custom frontends (Headless API)

If you are building a custom frontend with the Headless API, the pages endpoint automatically injects published collection items into matching sections:

GET /api/v1/public/pages/{slug}

The response includes each section's data. For sections mapped to a collection, the API merges published collection items into the section's item array. Your frontend receives the final, merged data.


Field mappings

When collection data flows into a section, fields are mapped automatically. Below is the mapping for each section that supports collections.

Blog Grid to Posts

Section FieldCollection Field
titletitle
excerptexcerpt
datepublishedAt
categorycategories
imagefeaturedImage
readTimecalculated from content length

Team to Team (and similar people collections)

Works with: team, staff, members, people, employees, board, volunteers, instructors, providers, agents

Section FieldCollection Field
namename
rolerole
biobio
imagephoto

Testimonials to Testimonials

Works with: testimonials, reviews, quotes

Section FieldCollection Field
nameauthor
roleauthorTitle
companyauthorCompany
quotequote
avatarauthorPhoto
ratingrating

FAQ to FAQs

Works with: faqs, questions

Section FieldCollection Field
questionquestion
answeranswer

Features Grid to Features

Works with: features, capabilities, benefits

Section FieldCollection Field
titlename
descriptiondescription
iconicon

Feature Showcase to Features

Works with: features, services, offerings

Section FieldCollection Field
titlename
descriptiondescription
imageimage
ctaLabelctaText
ctaHrefctaLink

Pricing to Pricing Plans

Works with: pricing-plans, plans, tiers

Section FieldCollection Field
namename
pricepriceMonthly
featuresfeatures
ctactaText
highlightedisPopular

Logo Cloud to Partners

Works with: partners, clients, logos

Section FieldCollection Field
namename

The partner's logo is rendered from the partner collection's logo field.


Tips

tip

You do not need collections to use any section. Collections are useful when you have items that change often, like blog posts or team members.

  • Start simple. Edit section content in the visual editor. Add collections later if needed.
  • Collections save repetition. When the same data appears on multiple pages, store it in a collection and update it once.
  • Headless API merges automatically. The pages endpoint delivers merged data -- no need to fetch collections separately.
  • Static sections stay static. Heroes, CTA Banner, Stats, Contact, Navbar, and Footer always use inline or global data.

Was this page helpful?