﻿---
title: Create release notes from changelogs
description: By adding a file for each notable change in your GitHub repository and grouping the files into bundles, you can ultimately generate release documentation...
url: https://www.elastic.co/elastic/docs-builder/docs/3291/reference/docs-builder/contribute/changelog
products:
  - Elastic Docs Builder
---

# Create release notes from changelogs
By adding a file for each notable change in your GitHub repository and grouping the files into bundles, you can ultimately generate release documentation with a consistent layout for all your products.
To use the `docs-builder changelog` commands in your development workflow:
1. [Configure changelogs](https://www.elastic.co/elastic/docs-builder/docs/3291/reference/docs-builder/contribute/configure-changelogs): Create a configuration file, map labels, and define rules for creation and bundling.
2. [Create changelogs](https://www.elastic.co/elastic/docs-builder/docs/3291/reference/docs-builder/contribute/create-changelogs) with the `docs-builder changelog add` command.
   - Alternatively, if you already have automated release notes for GitHub releases, you can use the `docs-builder changelog gh-release` command to create changelog files and a bundle from your GitHub release notes. Refer to [changelog gh-release cli command](https://www.elastic.co/elastic/docs-builder/docs/3291/reference/docs-builder/cli/changelog/gh-release).
3. [Bundle changelogs](https://www.elastic.co/elastic/docs-builder/docs/3291/reference/docs-builder/contribute/bundle-changelogs) with the `docs-builder changelog bundle` command. For example, create a bundle for the pull requests that are included in a product release. When changelogs are no longer needed in the repo, [remove changelog files](/elastic/docs-builder/docs/3291/reference/docs-builder/contribute/bundle-changelogs#changelog-remove) with `docs-builder changelog remove`.
4. [Publish release notes](https://www.elastic.co/elastic/docs-builder/docs/3291/reference/docs-builder/contribute/publish-changelogs): Use the `{changelog}` directive in docs or `docs-builder changelog render` to produce release documentation.

For more information about running `docs-builder`, go to [Contribute locally](https://www.elastic.co/docs/contribute-docs/locally).