How can i delete a remote tag?

To delete tags in a remote repository, use the git push command with the --delete option. Below is a step-by-step guide and example:

Step 1: First, identify the name of the remote tag you wish to delete. You can list all remote tags using these commands:

sh
git fetch --tags
git tag -l

Assume the remote tag name to delete is v1.0.

Step 2: Next, delete the remote tag using this command:

sh
git push --delete origin v1.0

In this command, origin refers to the remote repository name (typically origin), and v1.0 is the tag name.

Example:

Suppose you have a remote repository with a tag v1.0, and you need to delete it. Proceed as follows:

1. First, confirm the tag exists:

   sh
   

git fetch --tags git tag -l

shell

    This will list all tags, confirming that `v1.0` is present.

2. Then, delete the remote tag with the command:

    ```sh
git push --delete origin v1.0

shell
This command instructs Git to push a delete operation to the remote repository `origin` to remove the `v1.0` tag.

After running this command, the v1.0 tag in the remote repository will be removed. Alternatively, you can specify the tag using syntax such as :refs/tags/v1.0, but the --delete option is more intuitive and straightforward.

Additionally, before performing this operation, verify that you have the necessary permissions to delete tags in the remote repository, as it may impact other collaborators in a team project.

You can push an empty reference to the remote tag name:

shell
git push origin :tagname

Alternatively, more specifically, use the --delete option (or -d if your Git version is earlier than 1.8.0):

shell
git push --delete origin tagname

Note that Git has separate namespaces for tags and branches, so you can use the same name for both. If you want to ensure that you don't accidentally delete a branch instead of a tag, you can specify the full reference, which will never delete a branch:

shell
git push origin :refs/tags/tagname

If you also need to delete the local tag, use:

shell
git tag --delete tagname

---

Background

Pushing branches, tags, or other references to a remote repository involves specifying "which repository, what source, and what destination?"

shell
git push remote-repo source-ref:destination-ref

An example of pushing the main branch to the source's main branch is:

shell
git push origin refs/heads/master:refs/heads/master

Due to default paths, it can be shortened to:

shell
git push origin master:master

Tags work similarly:

shell
git push origin refs/tags/release-1.0:refs/tags/release-1.0

It can also be shortened to:

shell
git push origin release-1.0:release-1.0

By omitting the source reference (the part before the colon), you can push nothing to the destination, which deletes the reference on the remote end.