diff --git a/fern/products/docs/pages/changelog/2026-08-27.mdx b/fern/products/docs/pages/changelog/2026-08-27.mdx
new file mode 100644
index 0000000000..0da5315e05
--- /dev/null
+++ b/fern/products/docs/pages/changelog/2026-08-27.mdx
@@ -0,0 +1,18 @@
+## Blog layouts for changelogs
+
+navigation, customization
+
+You can now present a changelog as a blog, with dated entries rendered as cards in a grid or list, tag filters, search, and author bylines on each post. Use this layout when a changelog functions more like a series of announcement posts than a list of releases. Set `layout: blog` and `blog-layout` in the changelog overview frontmatter.
+
+
+
+
+
+
diff --git a/fern/products/docs/pages/navigation/assets/blog.mp4 b/fern/products/docs/pages/navigation/assets/blog.mp4
new file mode 100644
index 0000000000..e776b07ff9
Binary files /dev/null and b/fern/products/docs/pages/navigation/assets/blog.mp4 differ
diff --git a/fern/products/docs/pages/navigation/changelogs.mdx b/fern/products/docs/pages/navigation/changelogs.mdx
index 20c36b1d35..4f905565b0 100644
--- a/fern/products/docs/pages/navigation/changelogs.mdx
+++ b/fern/products/docs/pages/navigation/changelogs.mdx
@@ -1,11 +1,11 @@
---
title: Changelog pages
subtitle: Keep a chronological record of project changes with tagging, search, and RSS
-description: Configure changelog pages in Fern, including entry files, the timeline and classic layouts, tag filtering, and the RSS feed.
+description: Configure changelog pages in Fern, including entry files, timeline, classic, and blog layouts, tag filtering, and the RSS feed.
---
-A changelog is a navigation entry that renders a dated timeline of entries. Point the `changelog` key at a folder and every Markdown file in it becomes an entry, grouped by date, with search and tag filtering built in. A changelog can go wherever a section can — as its own tab, or as an entry in your sidebar.
+A changelog is a navigation entry that renders dated entries. Point the `changelog` key at a folder and every Markdown file in it becomes an entry, grouped by date, with search and tag filtering built in. A changelog can go wherever a section can — as its own tab, or as an entry in your sidebar.
@@ -188,10 +190,11 @@ Add an `overview.mdx` file to your `changelog` folder to include a high-level ov
## Customize layout
-Changelogs support two layouts:
+Changelogs support three layouts:
-- `timeline` (default) — a searchable timeline of condensed entry cards with plain-text excerpts.
+- `timeline` (default) — a searchable timeline of condensed entry cards with plain-text excerpts, one card per top-level `##` heading.
- `classic` — stacked full entries rendered inline, preserving code formatting, copy buttons, and links.
+- `blog` — a blog-style listing with one card per entry file, available only as a per-changelog override.
### Site-wide setting
@@ -220,6 +223,72 @@ Release history for the self-hosted Docker image.
The per-changelog override takes priority over the site-wide `layout.changelog-layout` setting.
+## Blog layout
+
+The `blog` layout renders one card for each dated entry file.
+
+
+
+
+
+Set `layout: blog` in the changelog folder's `overview.mdx` frontmatter. Use `blog-layout: grid` for the default card grid or `blog-layout: list` for full-width rows with the image beside the text.
+
+
+```mdx
+---
+layout: blog
+blog-layout: list
+authors:
+ garden-editor:
+ name: Garden editor
+ role: Horticulture
+---
+
+Updates from the Fern Garden team.
+```
+
+
+An optional `authors` map in the overview frontmatter registers authors by ID. Each author requires `name` and can include `role`, `avatar`, and `url`.
+
+Each entry file sets its own post metadata in frontmatter:
+
+
+
+ Sets the post title.
+
+
+
+ Overrides the post URL. The value is a full slug relative to the site base (or the product or version base, when one applies), so a post under a blog at `/blog` needs `slug: blog/my-post`. Omitting the `blog/` prefix publishes the post at `/my-post` instead of under the blog.
+
+
+
+ Adds tags to the post.
+
+
+
+ Sets the card excerpt. `subtitle` and `excerpt` are also accepted, in that order of precedence.
+
+
+
+ Path to the card and hero image. `image` is also accepted.
+
+
+
+ Names a key in the overview's `authors` registry, or an inline author object with `name`, `role`, `avatar`, and `url`. `authors` accepts a list of either form.
+
+
+
+ Excludes the post from the listing. `hidden: true` does the same.
+
+
+
## Linking and sharing
Each changelog entry has a unique URL you can direct users to. For example, `https://elevenlabs.io/docs/changelog/2025/3/31`
@@ -228,4 +297,6 @@ Search queries sync to the `?q=` URL parameter, so a search result is shareable
## RSS feed
-Changelogs automatically come with an RSS feed so users can subscribe to updates. Navigate to the RSS feed by appending `.rss` to the changelog path. For example, `https://elevenlabs.io/docs/changelog.rss`
+Changelogs automatically come with an RSS feed so users can subscribe to updates. Navigate to the RSS feed by appending `.rss` to the changelog path. For example, `https://elevenlabs.io/docs/changelog.rss`. Atom and JSON feeds are available at `.atom` and `.json`.
+
+Feeds require a recognized segment in the changelog's URL path: `blog`, `blogs`, `posts`, `changelog`, `changelogs`, `release-notes`, `releasenotes`, `whats-new`, or `whatsnew`. `fern check` reports an error for a changelog that resolves elsewhere.
diff --git a/fern/products/docs/pages/navigation/site-level-settings.mdx b/fern/products/docs/pages/navigation/site-level-settings.mdx
index 7869127e8d..fe560e0697 100644
--- a/fern/products/docs/pages/navigation/site-level-settings.mdx
+++ b/fern/products/docs/pages/navigation/site-level-settings.mdx
@@ -653,7 +653,7 @@ layout:
- `timeline` (default) — a searchable timeline of condensed entry cards with plain-text excerpts.
- `classic` — stacked full entries rendered inline, preserving code formatting, copy buttons, and links.
- Individual changelogs can override this setting with the `layout` frontmatter property in their [overview page](/learn/docs/configuration/changelogs#add-an-overview-page-optional).
+ Individual changelogs can override this setting with the `layout` frontmatter property in their overview page, including the per-changelog-only [`blog` layout](/learn/docs/configuration/changelogs#blog-layout).