Skip to main content

​
Step 1: create a new Page

1

Go to Pages

In the ButterCMS dashboard, click on Pages in the left sidebar.
2

Click New Page

Click the New Page button in the top right corner.
3

Select your Page Type

Choose Landing Page (or the Page Type you created in the previous step).

​
Step 2: set the page metadata

You’ll be prompted to enter a title and slug for your page.

​
Title

Enter a title to identify this page in the dashboard: homepage.

​
API Slug

This field auto-populates from your title, but you can change it to whatever you like. For this example, use homepage.
The API slug is the URL-friendly identifier for your page. You’ll use it to fetch this page via the API. For example, a landing-page page type and a homepage slug means you’ll fetch the page using /v2/pages/landing-page/homepage.

​
Step 3: fill in your content

Understanding the relationship:
  • Page Type = Your content schema (the structure/blueprint)
  • Page = An instance of that schema (the actual content)
When you create a Page Type, you’re defining the model your content will follow (including allowed fields and data types). When you create a Page within that Page Type, you’re creating content that follows that model.
You’ll see all the fields you defined in your Page Type. Let’s fill them in with sample content:

​
Sample content to enter

FieldSample value
headlineWelcome to Our Amazing Product
hero_imageUpload any image or use a placeholder
body_contentAdd some rich text content with headings and paragraphs
cta_button_textStart For Free
cta_button_link/signup
The WYSIWYG (What You See Is What You Get) editor provides a familiar word processor experience:The editor supports:
  • Text formatting: Bold, italic, underline, strikethrough
  • Headings: H1 through H6
  • Lists: Bulleted and numbered lists
  • Links: Internal and external links
  • Images: Inline images and media embeds
  • Code blocks: For technical content
  • Tables: Structured data presentation

​
Step 4: save and publish

1

Save as draft

Click Save to save your work without publishing. This creates a draft that only you can see.
2

Publish

When you’re ready, click Publish to make your content available via the API.
By default, only published content is returned by the Read API. To fetch draft content, add the preview parameter to your request with a value of 1, i.e., ?preview=1

​
Understanding the content workflow

ButterCMS uses a simple publishing workflow:
StatusAPI visibilityUse case
DraftHiddenWork in progress, can only be fetched from
API using ?preview=1
ScheduledHidden until dateContent set to auto-publish in the future, can be fetched with
preview parameter
PublishedVisibleLive content available to your app
You can make changes to published content by editing and re-publishing. ButterCMS also supports revision history so you can roll back if needed.

​
Preview your API response

Want to see what your content looks like as JSON?
  1. Click the three-dot menu (⋯) on your page
  2. Select API Explorer
  3. View your content’s JSON response directly
This is helpful for understanding the exact structure of your content before fetching it in your application.

​
What you’ve accomplished

You’ve created and published your first page with content!
Your content is now live and ready to be fetched via the ButterCMS API. Let’s do exactly that in the next step.

​
Next step

For developers: fetch content via API

Retrieve your content using the ButterCMS API

For content creators: check out the dashboard

Learn about dashboard essentials