Changelog

What Changelogs Do

Relevate can turn a folder of release notes into a polished changelog section with index pages, entry pages, search records, RSS feeds, and localized routes.

Use changelogs when you want product updates to feel like part of the docs instead of a separate blog or manually maintained page.

Enable A Changelog

Add a changelog collection to docs.json and place the changelog tab in navigation.

{
  "changelog": {
    "path": "/changelog"
  },
  "navigation": {
    "tabs": [
      {
        "id": "docs",
        "label": "Docs",
        "content": ["getting-started"]
      },
      {
        "id": "changelog",
        "label": "Changelog",
        "icon": "clock",
        "content": ["changelog"]
      }
    ]
  }
}

Then create a changelog folder:

Entry Frontmatter

Every changelog entry needs frontmatter. The body below the frontmatter can use normal Markdown and Relevate components.

---
title: Team workspaces
description: Invite teammates, organize docs, and manage access from one workspace.
type: new
date: 2026-04-08
label: April 2026
tags: ["Teams", "Permissions"]
rss:
  title: Team workspaces
  description: Team workspaces, invitations, and access settings for RSS subscribers.
---

Team workspaces make it easier to manage documentation with the rest of your company.

## What's included

- Invite teammates by email.
- Group docs by workspace.
- Keep billing and access settings in one place.

File Names And Slugs

Relevate derives the public entry slug from the file name.

The first two examples become /changelog/team-workspaces. The manual slug becomes /changelog/custom-launch.

Changelog Index

changelog/index.mdx is optional. Use it to override the collection title, description, or add intro content above the generated entries.

---
title: Product Updates
description: New features, fixes, and release notes.
---

Follow this page for the latest Relevate changes.

Multiple Changelogs

Use changelogs when you need more than one release stream.

{
  "changelogs": {
    "api": {
      "path": "/api/changelog"
    },
    "platform": {
      "path": "/platform/changelog"
    }
  }
}

Each collection uses the same folder and frontmatter model. Add each root to navigation where readers expect it.

Localization

Changelogs follow the same locale folder rules as pages.

Keep translated entry slugs aligned when you want language switching to feel predictable.

Generated Output

When a changelog is configured, Relevate generates:

• A changelog index route such as /changelog

• Entry routes such as /changelog/team-workspaces

• Paginated changelog pages when needed

• RSS feeds at /rss.xml for the default changelog and /{collection}/rss.xml for named collections

• Tag filters for entries that include tags

• Search and assistant-ready records for visible changelog content