> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vers.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Repo tag delete

# vers repo tag delete

Delete tags by name. The commits they pointed at are **not** deleted.

## Synopsis

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag delete <repo-name> <tag-name>...
```

## Description

Accepts one repo name followed by one or more tag names in that repo. Each tag is deleted independently; if one fails, the command keeps going and reports the first error on exit.

Deleting a tag is a pointer removal only. If the commit it named is still referenced by a VM or another tag, it stays reachable. Otherwise it becomes orphaned (but not immediately reclaimed).

## Examples

### Delete a single tag

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag delete my-app staging
# ✓ Tag 'staging' deleted from 'my-app'
```

### Delete several

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag delete my-app v1.0 v1.1 v1.2
# ✓ Tag 'v1.0' deleted from 'my-app'
# ✓ Tag 'v1.1' deleted from 'my-app'
# ✓ Tag 'v1.2' deleted from 'my-app'
```

### Delete all tags in a repo (but keep the repo)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag delete my-app $(vers repo tag list my-app -q)
```

## Error Cases

### Repository or tag not found

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag delete my-app ghost
# ✗ Failed to delete tag 'ghost': Repository or tag not found
```

The command continues with any remaining tag names and returns the first error at the end.

## See Also

* [`vers repo delete`](/cli-reference/repo-delete) - delete the whole repository (also removes all tags)
* [`vers repo tag list`](/cli-reference/repo-tag-list)