glab(1)                                                                glab(1)



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



SYNOPSIS
       glab container-registry tag delete  [] [flags]



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


       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.


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


       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.



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


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


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


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


       -y, --yes[=false]   Skip the confirmation prompt.



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


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



EXAMPLE
       # 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



SEE ALSO
       glab-container-registry-tag(1)

Auto generated by spf13/cobra      Sep 2026                            glab(1)