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

# Create sample content

> Add content to the Page Type you just created

## Step 1: create a new Page

<Steps>
  <Step title="Go to Pages">
    In the ButterCMS dashboard, click on **Pages** in the left sidebar.
  </Step>

  <Step title="Click New Page">
    Click the **New Page** button in the top right corner.
  </Step>

  <Step title="Select your Page Type">
    Choose **Landing Page** (or the Page Type you created in the previous step).
  </Step>
</Steps>

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

<Note>
  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`.
</Note>

## Step 3: fill in your content

<Tip>
  **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.
</Tip>

You'll see all the fields you defined in your Page Type. Let's fill them in with sample content:

{/* /SOURCE */}

### Sample content to enter

| Field                 | Sample value                                            |
| --------------------- | ------------------------------------------------------- |
| **headline**          | Welcome to Our Amazing Product                          |
| **hero\_image**       | Upload any image or use a placeholder                   |
| **body\_content**     | Add some rich text content with headings and paragraphs |
| **cta\_button\_text** | Start For Free                                          |
| **cta\_button\_link** | /signup                                                 |

<Info>
  The WYSIWYG (What You See Is What You Get) editor provides a familiar word processor experience:

  {/* /SOURCE */}

  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
</Info>

## Step 4: save and publish

<Steps>
  <Step title="Save as draft">
    Click **Save** to save your work without publishing. This creates a draft that only you can see.
  </Step>

  <Step stepNumber={2} title="Publish">
    When you're ready, click **Publish** to make your content available via the API.
  </Step>
</Steps>

<Tip>
  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`
</Tip>

## Understanding the content workflow

ButterCMS uses a simple publishing workflow:

| Status        | API visibility    | Use case                                                                                |
| ------------- | ----------------- | --------------------------------------------------------------------------------------- |
| **Draft**     | Hidden            | Work in progress, can only be fetched from<br />API using `?preview=1`                  |
| **Scheduled** | Hidden until date | Content set to auto-publish in the future, can be fetched with<br />`preview` parameter |
| **Published** | Visible           | Live content available to your app                                                      |

<Tip>
  You can make changes to published content by editing and re-publishing. ButterCMS also supports [revision history](../create-content/versioning-history/revision-history-overview) so you can roll back if needed.
</Tip>

## Preview your API response

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

## What you've accomplished

<Check>
  You've created and published your first page with content!
</Check>

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

<Card icon="code" href="./fetch-content" title="For developers: fetch content via API">
  Retrieve your content using the ButterCMS API
</Card>

<Card icon="code" href="../create-content/creating-editing-content/dashboard-essentials/dashboard-overview" title="For content creators: check out the dashboard">
  Learn about dashboard essentials
</Card>