Documentation Index
Fetch the complete documentation index at: https://buttercms.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Implementing common use cases
Several common use cases for References include:
- Page Facets for grouping/filtering
- Reusable promotional page content
- Tables of related content
Explore the tabs below to learn how to configure your content for each of these use cases in your ButterCMS dashboard, as well as how to fetch content from the API.
Categories (grouping and filtering content)
Testimonials (reusable content)
Related articles (referencing related content)
You can use Collections to store reusable promotional content that can be referenced by multiple pages. A common example may be customer testimonials.Create a Collection for testimonials with fields for name, quote, headshot, and title/company:
Add testimonials to your Collection:
Select testimonials for your page:
API Response:{
"testimonials": [
{
"name": "Maggie Summers",
"headshot": "https://cdn.buttercms.com/maggie.jpg",
"title_company": "Sasquatch",
"quote": "After several attempts at implementing an open source CMS, I found Butter. It's the best!"
},
{
"name": "Drew Johnson",
"headshot": "https://cdn.buttercms.com/drew.jpg",
"title_company": "App Partner",
"quote": "Wordpress was too slow. Butter is more performant. A no brainer."
}
]
}
Let’s say you’ve added an articles section to your website and you want to make the articles even more helpful by showing related articles. References make this very simple to achieve.Add a Reference field to your Articles page type for Related Articles. It will link to many articles, so it’s One-to-Many and links back to itself.
Adding and removing related articles:
Add categories to your Collection:
API Response with Category:Filtering by Category: