Changelog

This guide is part of the Drizzle stack docs.

The changelog is a page that displays the product updates and release notes to keep users informed. This is a great way to keep your users updated about the latest features and improvements, and to build trust with your users. It is accessible at /changelog.

Changelog Structure

Organize updates using meaningful slugs for best SEO:

apps/web/content/changelog/
├── v1.0.0-improved-security.mdoc
├── v1.1.0-ai-powered-features.mdoc
└── v1.2.0-new-dashboard-ui.mdoc

Changelog Entry Format

The Changelog entries take the same format as the blog posts and documentation pages using our unified CMS package. Entries are stored in the content/changelog folder and sorted by date as specified in the publishedAt field.

Below is an example of a changelog entry:

---
publishedAt: "2025-01-15"
title: "Custom Roles & Permissions"
description: "Major security updates including SAML SSO, audit logs, and enhanced access controls to keep your data safe and compliant."
categories: []
tags: []
status: "published"
---
## What's New
### Custom Roles
You can now create custom roles with granular permissions:
- Define custom role names
- Assign specific permissions
- Control access at feature level
### Bug Fixes
- Fixed issue with email verification
- Improved session handling

Next: FAQ →