What are pages?
Pages let you model and manage structured content entries using custom fields and reusable components. Each page follows a defined schema, and can represent any slug-based content in your app. They have the following benefits:Components
Group any number of fields into a component with its own name and slug. When the page is fetched from our API, the component will be returned as an object under its slug in the page’s JSON data.
Components are excellent for structuring page data in a logical way. For example, you could divide a page into components like SEO & Metadata, Page Identity, Hero & Header, Body Content, and Footer.
Component Library
Saving a component to your Component Library makes it available to be reused in any other Page schema. Components can also be migrated between environments for workflows that require clear separation of development and production content.
Schema reusability
In addition to components, you can convert your Single Page into a Page Type that allows you to create a theoretically unlimited number of pages with the same data structure, making it easy to map data to templates in your codebase and render structured content consistently.
Schema flexibility, within the limits that you define
The Component Picker field allows you to set an allowlist of predefined components for marketers to use with that field.
References to other ButterCMS content
Pages can reference other ButterCMS content, including Single Pages, Page Types, and Collections, allowing for complex, nested data structures.
When to use pages
Pages are ideal for:- Marketing pages: Landing pages, feature pages, and pricing pages (use a reusable Page Type for these).
- One-off pages: About us, contact, and careers (use a Single Page).
- Content-rich pages: Case studies and customer stories
- Dynamic sections: Homepage with multiple content blocks
Learn more
Field Types reference
All available field types for Pages and Collections, and their use
Creating pages
Learn how to create Single Pages and Page Types in the ButterCMS dashboard
API: Fetch Pages
REST API for reading pages
API: Create Pages
REST API for creating, editing, and deleting pages
Next steps
Collections
Learn about structured data tables
Components
Build reusable content blocks