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

.SH NAME
glab-container-registry-tag-delete - Delete container registry tags.


.SH SYNOPSIS
\fBglab container-registry tag delete  [] [flags]\fP


.SH DESCRIPTION
Delete one container registry tag by name, or delete matching tags in
bulk by filter.

.PP
Deleting a single tag is synchronous. Bulk deletion is scheduled
asynchronously by GitLab; matching tags may remain visible until the
background deletion job has completed.

.PP
To bulk delete tags, omit  and provide at least one bulk
deletion flag: --name-regex-delete, --name-regex-keep, --keep-n, or
--older-than.

.PP
The repository ID must belong to the selected project. Use -R/--repo
to specify the owning project when running this command outside that
project's Git checkout.


.SH OPTIONS
\fB--keep-n\fP=0
	Keep the latest N matching tags. Bulk deletion only; scheduled asynchronously.

.PP
\fB--name-regex-delete\fP=""
	Regular expression for tag names to delete. Bulk deletion only; scheduled asynchronously.

.PP
\fB--name-regex-keep\fP=""
	Regular expression for tag names to keep. Bulk deletion only; scheduled asynchronously.

.PP
\fB--older-than\fP=""
	Delete tags older than the given duration, such as 7d or 1month. Bulk deletion only; scheduled asynchronously.

.PP
\fB-y\fP, \fB--yes\fP[=false]
	Skip the confirmation prompt.


.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
# Delete a container registry tag with a confirmation prompt
glab container-registry tag delete 123 latest

# Skip the confirmation prompt
glab container-registry tag delete 123 latest --yes

# Schedule tags matching a regular expression for deletion
glab container-registry tag delete 123 --name-regex-delete '^release-.*' --yes

# Schedule old tags for deletion, but keep the 10 most recent matching tags
glab container-registry tag delete 123 --name-regex-delete '.*' --keep-n 10 --older-than 30d --yes

# Delete a container registry tag in another project
glab container-registry tag delete 123 latest -R gitlab-org/cli
.EE


.SH SEE ALSO
\fBglab-container-registry-tag(1)\fP