> ## 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.

# Pages

> Pages are ButterCMS's most versatile content type — create custom structures for landing pages, feature pages, case studies, and more.

## 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:

<Card title="Components" icon="puzzle-piece">
  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.

  <Info>
    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.**
  </Info>
</Card>

<Card title="Component Library" icon="book">
  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.
</Card>

<Card title="Schema reusability" icon="copy">
  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.
</Card>

<Card title="Schema flexibility, within the limits that you define" icon="filters">
  The Component Picker field allows you to set an allowlist of predefined components for marketers to use with that field.
</Card>

<Card title="References to other ButterCMS content" icon="link">
  Pages can reference other ButterCMS content, including Single Pages, Page Types, and Collections, allowing for complex, nested data structures.
</Card>

## 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

<CardGroup cols={2}>
  <Card title="Field Types reference" icon="input-text" href="../field-types/field-basics">
    All available field types for Pages and Collections, and their use
  </Card>

  <Card title="Creating pages" icon="file-plus" href="../../create-content/creating-editing-content/add-pages-collections-posts/creating-pages">
    Learn how to create Single Pages and Page Types in the ButterCMS dashboard
  </Card>

  <Card title="API: Fetch Pages" icon="code" href="../../api-reference/pages/get-multiple-pages">
    REST API for reading pages
  </Card>

  <Card title="API: Create Pages" icon="pen" href="../../api-reference/pages/create-page-via-write-api">
    REST API for creating, editing, and deleting pages
  </Card>
</CardGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Collections" icon="database" href="./collections">
    Learn about structured data tables
  </Card>

  <Card title="Components" icon="puzzle-piece" href="../field-types/components">
    Build reusable content blocks
  </Card>
</CardGroup>