glab(1)

🎀 NAME 🎀

glab-container-registry-tag-delete — delete container registry tags, bestie 💅

(you'll find this gem tucked inside the glab(1) manual, iykyk 🦋)

---

✨ SYNOPSIS ✨

glab container-registry tag delete  [] [flags]

---

💖 DESCRIPTION 💖

okay so here's the tea ☕ — this command deletes one container registry tag by name, or it deletes matching tags in bulk by filter. two modes, one icon 👑

Deleting a single tag is synchronous, meaning it just... happens. right then. no waiting around 💀

Bulk deletion tho? that's scheduled asynchronously by GitLab, so matching tags may stay visible until that background deletion job has finished doing its thing. so if you're like "why are they still there 😭" — give it a sec, the little job is working on it 🧚

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

The repository ID must belong to the selected project. Use -R/--repo to specify the owning project when you're running this command outside that project's Git checkout — like, if you're not standing in the repo, you gotta point at it 🫶

---

🌈 OPTIONS 🌈

• --keep-n=0 — keep the latest N matching tags. bulk deletion only, and it's 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, like 7d or 1month. bulk deletion only, scheduled asynchronously 🦋
• -y, --yes[=false] — skip the confirmation prompt. no more "are you sure" jumpscare 🙈

---

👑 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, slay 🌟

---

🔥 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) — go say hi to the parent command, she raised this one 💐

---

that's the whole vibe check, bestie ✨ auto generated by spf13/cobra, dated Nov 2026, and it's part of the glab(1) manual — mwah, go delete some tags responsibly 💅💖