# Changelog

> Display product updates and release notes to keep users informed.

*Canonical: https://makerkit.dev/docs/tanstack-drizzle/marketing-pages/changelog*

---

This guide is part of the [Drizzle](/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:

```mdx {% title="apps/web/content/changelog/2025-01-15-custom-roles-and-permissions.mdoc" %}
---
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 →](./faq)