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

# Blog Engine

> ButterCMS includes a fully-featured Blog Engine out of the box, complete with posts, authors, categories, tags, and SEO fields.

## What is the Blog Engine?

The Blog Engine is a structured template designed for traditional blog functionality. It provides a complete, ready-to-use blogging solution with pre-defined fields for posts, authors, categories, and tags.

## Key features

<Card title="Posts" icon="file-lines">
  Rich blog posts with HTML body, featured images, and metadata.

  <Tip>
    To see all the fields available in the API response, check the [Blog API reference](../../api-reference/blog-posts/retrieve-single-post).
  </Tip>
</Card>

<Card title="Author management" icon="users">
  Users with the right permissions in your ButterCMS account can update their profiles with a bio, photo, and social links.
</Card>

<Card title="SEO component" icon="magnifying-glass">
  Out-of-the-box SEO management with a prebuilt SEO component, including content summaries, metadata fields, and featured images.
</Card>

<Card title="Categories and tags" icon="tags">
  Organize posts into categories for navigation and primary grouping, or add tags for flexible content discovery.
</Card>

<Card title="Smart, easy filtering options" icon="filters">
  Posts can be filtered inside the ButterCMS dashboard via category, tag, or author. Or, they can be filtered via the API using the `category_slug`, `author_slug`, or `tag_slug` [parameters](../../api-reference/blog-posts/list-all-posts).
</Card>

<Card title="Blog Posts API Reference" icon="code">
  View our [full API documentation for reading and filtering blog posts](../../api-reference/blog-posts/list-all-posts).
</Card>

## Will Blog Engine meet my needs?

Blog Engine is a ready-to-use, no-setup solution. It's ideal for:

* **Company blogs**: News, updates, announcements
* **Content marketing**: Tutorials, guides, how-tos
* **News sites**: Articles with authors and categories
* **Simple blogs**: When you don't need custom fields

<Tip>
  If you need more flexibility than the Blog Engine offers, like the ability to add custom components, you'll want to set up a custom [Page Type](../../build-your-app/how-to-recipes/build/building-a-blog-page-type) for your blog instead of using the built-in Blog Engine.
</Tip>

## Blog Engine vs. setting up a custom Page Type

| Feature             | Blog Engine     | Custom Pages           |
| ------------------- | --------------- | ---------------------- |
| **Setup**           | Ready to use    | Requires schema setup  |
| **Flexibility**     | Fixed structure | Fully customizable     |
| **Authors**         | ✅ Built-in      | Create via Collections |
| **Categories/Tags** | ✅ Built-in      | Create via Collections |
| **Localization**    | ✅ Built-in      | ✅ Fully supported      |
| **Components**      | ❌ Not available | ✅ Fully supported      |
| **SEO Fields**      | ✅ Built-in      | Add manually           |

## Learn more

<CardGroup cols={2}>
  <Card title="Creating Blog Posts" icon="input-text" href="../../create-content/creating-editing-content/add-pages-collections-posts/creating-blog-posts">
    Learn how to create and link to Blog Posts in the ButterCMS dashboard
  </Card>

  <Card title="API: Blog Posts" icon="code" href="../../api-reference/blog-posts/list-all-posts">
    REST API for reading blog posts
  </Card>

  <Card title="API: Authors and categories" icon="users" href="../../api-reference/blog-metadata/list-all-authors">
    REST API for blog metadata
  </Card>

  <Card icon="hammer" href="../../build-your-app/how-to-recipes/build/building-a-blog-page-type" title="Building a Blog Page Type">
    Step-by-step implementation guide for a custom Blog Page Type
  </Card>
</CardGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Choosing the right content type" icon="input-text" href="./choosing-content-type">
    An overview of the various field types supported by ButterCMS
  </Card>

  <Card title="Field types" icon="input-text" href="../field-types/field-basics">
    An overview of the various field types supported by ButterCMS
  </Card>
</CardGroup>