Skip to main content

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.

​
Quick references

Overview: ButterCMS content types

Check out our core concepts article on Pages, Collections, and the Blog Engine to understand the differences between these content types and when to use each one.

Pages deep dive

Take a deep dive into the Page content type, including features, supported fields, and more.

​
Create a Page

You must have adequate permissions to create a new Page or Page Type.
If you tend to learn by doing, check out our tutorial on dynamic landing pages for an example of how to set up a Page with advanced field types, like components and repeaters.
1

Click the Create a page button

To create a new Page, click on Pages in the sidebar, and then click on the New Page button in the top right. Choose one of your pre-existing Page Types, or click on Create new page.
If you want to create a new instance of a Page Type that you’ve already set up, hover over the Pages sidebar menu item and click the grey plus sign next to the Page Type.
2

Add fields

Click on a field type in the menu pane that appears to add it to your Page schema. Give the field a name, slug, and add any necessary configuration options.
For more information on the various field types and the configuration options they offer, such as default values, help text, validation, and more, check out our core concepts article on fields.
3

Click the Save button

Click the Save button in the upper-right corner to save the fields to the Page schema.
4

Save Page metadata

Fill in the Page title. You can either use the API slug that autopopulates or choose your own. Then, click Save Page Metadata.
5

Fill in fields

Fill in your page data.
6

Save or publish your page

Click on Publish or Save Draft to keep your Page changes.
Pages support advanced field types, such as reference fields, repeaters, components, component pickers, and forms. You can select any of those topics from the left side menu to learn more.

​
Edit existing pages

  1. Open Pages.
  2. Search or filter to find a page.
  3. Edit and Save or Publish.

​
Converting a single Page to a Page Type

Single Pages can easily be converted into Page Types for reuse.
1

Open the page

Open the page by selecting it from the Pages pane.
2

Launch the edit schema interface

Click on the three-dots icon (meatball icon) to open Page configuration options, and click on Edit schema.
3

Create the Page Type

Click the Create Page Type button in the upper left. Give the new Page Type a name, and click on Save as Page Type.

​
Creating a Page Type

You can also create a Page Type without creating a Single Page first. Just click on Content Types in the left sidebar. Then select New Content Type and Page Type.

​
Next steps for managing content

Learn about content statuses, such as published and draft, how to schedule content, how to preview changes in the dashboard, how versioning works, and more.

Understanding content status

Managing drafts

Previewing changes in the dashboard

Scheduling content

Versioning & history

Deleting content