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

.SH NAME
glab-release-list - List releases in a repository.


.SH SYNOPSIS
\fBglab release list [flags]\fP


.SH DESCRIPTION
By default, lists the releases for the current project, most recent
first. Use \fB--repo\fR to target a different project, or \fB-F json\fR for
machine-readable output.


.SH OPTIONS
\fB--jq\fP=""
	Filter JSON output with a jq expression.

.PP
\fB-F\fP, \fB--output\fP="text"
	Format output as: text, json.

.PP
\fB-p\fP, \fB--page\fP=1
	Page number.

.PP
\fB-P\fP, \fB--per-page\fP=30
	Number of items to list per page.


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

.PP
\fB-R\fP, \fB--repo\fP=""
	Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.


.SH EXAMPLE
.EX
glab release list
glab release list --per-page 50
glab release list -R owner/repository
glab release list -F json
.EE


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