> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelogs

> Post product updates in your docs with a subscribable RSS feed

Create a changelog for your docs by adding [Update components](/components/update) to a page.

Check out the [Mintlify changelog](/changelog) as an example: you can include links, images, text, and demos of your new features in each update.

## Setting up your changelog

<Steps>
  <Step title="Create a page for your changelog">
    1. Create a new page in your docs such as `changelog.mdx` or `updates.mdx`.
    2. Add your changelog page to your navigation scheme in your `docs.json`.
  </Step>

  <Step title="Add Update components to your changelog">
    Add an `Update` for each changelog entry.

    Include relevant information like feature releases, bug fixes, or other announcements.
  </Step>
</Steps>

```mdx Example changelog.mdx theme={null}
---
title: "Changelog"
description: "Product updates and announcements"
---
<Update label="March 2025" description="v0.0.10">
  Added a new Wintergreen flavor.

  Released a new version of the Spearmint flavor, now with 10% more mint.
</Update>

<Update label="February 2025" description="v0.0.09">
  Released a new version of the Spearmint flavor.
</Update>
```

## Customizing your changelog

Control how people navigate your changelog and stay up to date with your product information.

### Table of contents

Each `label` property for an `Update` automatically creates an entry in the right sidebar's table of contents. This is the default navigation for your changelog.

<Frame>
  <img src="https://mintcdn.com/omer-914cc1c6/R6mDx4eU2EptKC2P/images/changelog-toc-light.png?fit=max&auto=format&n=R6mDx4eU2EptKC2P&q=85&s=8c16329ed1c814d832aae01ac8c9f161" alt="Changelog with table of contents displayed in light mode." className="block dark:hidden" width="2632" height="1502" data-path="images/changelog-toc-light.png" />

  <img src="https://mintcdn.com/omer-914cc1c6/R6mDx4eU2EptKC2P/images/changelog-toc-dark.png?fit=max&auto=format&n=R6mDx4eU2EptKC2P&q=85&s=9ac2ce4351fffb91c7382f30dc30e345" alt="Changelog with table of contents displayed in dark mode." className="hidden dark:block" width="2590" height="1432" data-path="images/changelog-toc-dark.png" />
</Frame>

### Tag filters

Add `tags` to your `Update` components to replace the table of contents with tag filters. Users can filter the changelog by selecting one or more tags:

```mdx Tag filters example wrap theme={null}
<Update label="March 2025" description="v0.0.10" tags={["Wintergreen", "Spearmint"]}>
  Added a new Wintergreen flavor.

  Released a new version of the Spearmint flavor, now with 10% more mint.
</Update>

<Update label="February 2025" description="v0.0.09" tags={["Spearmint"]}>
  Released a new version of the Spearmint flavor.
</Update>

<Update label="January 2025" description="v0.0.08" tags={["Peppermint", "Spearmint"]}>
  Deprecated the Peppermint flavor.

  Released a new version of the Spearmint flavor.
</Update>
```

<Frame>
  <img src="https://mintcdn.com/omer-914cc1c6/R6mDx4eU2EptKC2P/images/changelog-filters-light.png?fit=max&auto=format&n=R6mDx4eU2EptKC2P&q=85&s=f43e7c62526bc32a1be9568f7311dd9b" alt="Changelog in light mode with the Peppermint tag filter selected." className="block dark:hidden" width="2170" height="582" data-path="images/changelog-filters-light.png" />

  <img src="https://mintcdn.com/omer-914cc1c6/R6mDx4eU2EptKC2P/images/changelog-filters-dark.png?fit=max&auto=format&n=R6mDx4eU2EptKC2P&q=85&s=e723d7f298ad1a892f6cd0d02b7537d3" alt="Changelog in dark mode with the Peppermint tag filter selected." className="hidden dark:block" width="2172" height="584" data-path="images/changelog-filters-dark.png" />
</Frame>

<Tip>
  The table of contents and changelog filters are hidden when using `custom`, `center`, or `wide` page modes. Learn more about [page modes](/pages#page-mode).
</Tip>

### Subscribable changelogs

Using `Update` components creates a subscribable RSS feed at your page URL with `/rss.xml` appended. For example, `mintlify.com/docs/changelog/rss.xml`.

Entries are added to the RSS feed when new `Update` components are published and when new headings are added inside of existing `<Update>` tags.

The top level headings of `Update` components are used as the titles of RSS feed entries, and the entries link to their heading anchors in your docs.

```xml Example RSS feed theme={null}
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0">
  <channel>
    <title><![CDATA[Product updates]]></title>
    <description><![CDATA[New updates and improvements]]></description>
    <link>https://mintlify.com/docs</link>
    <generator>RSS for Node</generator>
    <lastBuildDate>Mon, 21 Jul 2025 21:21:47 GMT</lastBuildDate>
    <atom:link href="https://mintlify.com/docs/changelog/rss.xml" rel="self" type="application/rss+xml"/>
    <copyright><![CDATA[Mintlify]]></copyright>
    <docs>https://mintlify.com/docs</docs>
    <item>
      <title><![CDATA[June 2025]]></title>
      <link>https://mintlify.com/docs/changelog#june-2025</link>
      <guid isPermaLink="true">https://mintlify.com/docs/changelog#june-2025</guid>
      <pubDate>Mon, 23 Jun 2025 16:54:22 GMT</pubDate>
    </item>
  </channel>
</rss>
```

RSS feeds can integrate with Slack, email, or other subscription tools to notify users of product changes. Some options include:

* [Slack](https://slack.com/help/articles/218688467-Add-RSS-feeds-to-Slack)
* [Email](https://zapier.com/apps/email/integrations/rss/1441/send-new-rss-feed-entries-via-email) via Zapier
* Discord bots like [Readybot](https://readybot.io) or [RSS Feeds to Discord Bot](https://rss.app/en/bots/rssfeeds-discord-bot)

To make the RSS feed discoverable, you can display an RSS icon button that links to the feed at the top of the page. Add `rss: true` to the page frontmatter:

```mdx theme={null}
---
rss: true
---
```

<Frame>
  <img src="https://mintcdn.com/omer-914cc1c6/R6mDx4eU2EptKC2P/images/changelog-rss-button-light.png?fit=max&auto=format&n=R6mDx4eU2EptKC2P&q=85&s=6f311de37b9c20f599301c8293394aa1" alt="Changelog page in light mode with RSS feed button enabled." className="block dark:hidden" width="1486" height="388" data-path="images/changelog-rss-button-light.png" />

  <img src="https://mintcdn.com/omer-914cc1c6/R6mDx4eU2EptKC2P/images/changelog-rss-button-dark.png?fit=max&auto=format&n=R6mDx4eU2EptKC2P&q=85&s=8e0eadc5a58b3df94ab67e5638ab779f" alt="Changelog page in dark mode with RSS feed button enabled." className="hidden dark:block" width="1486" height="388" data-path="images/changelog-rss-button-dark.png" />
</Frame>