.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH NAME
glab-changelog-generate - Generate a changelog for the current project.


.SH SYNOPSIS
\fBglab changelog generate [flags]\fP


.SH DESCRIPTION
Generates a changelog from the commits in your project's Git
repository. If you do not pass \fB--version\fR, glab determines
the version by running \fBgit describe\fR against your local tags.

.PP
By default, GitLab reads the changelog configuration from
\fB\&.gitlab/changelog_config.yml\fR in the project. To use a
different file, pass \fB--config-file\fR\&.

.PP
To limit the range of commits, use \fB--from\fR and \fB--to\fR\&.
glab excludes the \fB--from\fR commit from the range and includes
the \fB--to\fR commit. The \fB--to\fR commit defaults to
\fBHEAD\fR of the project's default branch.


.SH OPTIONS
\fB--config-file\fP=""
	Path to the changelog configuration file in the project's Git repository. Defaults to '.gitlab/changelog_config.yml'.

.PP
\fB--date\fP=""
	Date and time of the release, in ISO 8601 format (2016-03-11T03:45:40Z). Defaults to the current time.

.PP
\fB--from\fP=""
	Start of the range of commits to use when generating the changelog, as a SHA. This commit is not included in the range.

.PP
\fB--to\fP=""
	End of the range of commits to use when generating the changelog, as a SHA. This commit is included in the range. Defaults to the HEAD of the project's default branch.

.PP
\fB--trailer\fP=""
	The Git trailer to use to include commits. Defaults to 'Changelog'.

.PP
\fB-v\fP, \fB--version\fP=""
	Version to generate the changelog for. Must follow semantic versioning. Defaults to the version detected by 'git describe'.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB-h\fP, \fB--help\fP[=false]
	Show help for this command.


.SH EXAMPLE
.EX
# Generate a changelog for the version detected by 'git describe'
glab changelog generate

# Generate a changelog for a specific version
glab changelog generate --version 1.2.0

# Generate a changelog for commits between two SHAs
glab changelog generate --from abc123 --to def456

.EE


.SH SEE ALSO
\fBglab-changelog(1)\fP