632

We use tags in git as part of our deployment process. From time to time, we want to clean up these tags by removing them from our remote repository.

This is pretty straightforward. One user deletes the local tag and the remote tag in one set of commands. We have a little shell script that combines both steps.

The 2nd (3rd, 4th,...) user now has local tags that are no longer reflected on the remote.

I am looking for a command similar to git remote prune origin which cleans up locally tracking branches for which the remote branch has been deleted.

Alternatively, a simple command to list remote tags could be used to compare to the local tags returned via git tag -l.

3

16 Answers 16

1313

This is great question, I'd been wondering the same thing.

I didn't want to write a script so sought a different solution. The key is discovering that you can delete a tag locally, then use git fetch to "get it back" from the remote server. If the tag doesn't exist on the remote, then it will remain deleted.

Thus you need to type two lines in order:

git tag -l | xargs git tag -d
git fetch --tags

These:

  1. Delete all tags from the local repo. FWIW, xargs places each tag output by "tag -l" onto the command line for "tag -d". Without this, git won't delete anything because it doesn't read stdin (silly git).

  2. Fetch all active tags from the remote repo.

This even works a treat on Windows.

13
  • 33
    as noted in a separate answer, this deletes ALL local tags, and ones not in the remote repo obviously won't be re-created
    – second
    Aug 6, 2012 at 11:03
  • 3
    Does the first command require an xargs extension or something? I get this when executing that command in windows cmd: 'xargs' is not recognized as an internal or external command, operable program or batch file. Jun 2, 2014 at 18:39
  • 20
    FWIW this should be completely unnecessary. There should be a git tag prune origin command. Jun 5, 2014 at 14:41
  • 9
    This might not work for everybody. You should do git fetch --tags to be on the safe side. Jul 13, 2015 at 17:12
  • 12
    I had to go git tag -l | %{git tag -d $_} to get this working in PowerShell. Not sure about anyone else.
    – Alain
    Dec 20, 2016 at 20:27
309

From Git v1.7.8 to v1.8.5.6, you can use this:

git fetch <remote> --prune --tags

Update

This doesn't work on newer versions of git (starting with v1.9.0) because of commit e66ef7ae6f31f2. I don't really want to delete it though since it did work for some people.

As suggested by "Chad Juliano", with all Git version since v1.7.8, you can use the following command:

git fetch --prune <remote> +refs/tags/*:refs/tags/*

You may need to enclose the tags part with quotes (on Windows for example) to avoid wildcard expansion:

git fetch --prune <remote> "+refs/tags/*:refs/tags/*"

NOTE: in all these cases would be likely be "origin" or whichever remote you might usually reference.

13
  • 2
    I refer to the documentation that is packaged with Git for Windows 1.9.4-preview20140611 (and i suspect all previous versions). I access said documentation with "git fetch --help" [quote]Tags are not subject to pruning if they are fetched only because of the default tag auto-following or due to a --tags option.[/quote] Jul 29, 2014 at 8:17
  • 3
    git fetch --prune <remote> +refs/tags/*:refs/tags/* didn't work in ZSH however it works in BASH
    – Alex
    Aug 12, 2015 at 10:35
  • 4
    @Alex That's just because zsh expands * but if you single quote that it should be fine.
    – NSF
    Jun 20, 2016 at 4:30
  • 16
    @v01pe - there is now a git shortcut --prune-tags available since git 2.17.0 described in the documentation under the PRUNING section: git-scm.com/docs/git-fetch/2.17.0 From the document: The --prune-tags option is equivalent to having refs/tags/*:refs/tags/* declared in the refspecs of the remote. Equivalents: git fetch origin --prune --prune-tags OR git fetch origin --prune 'refs/tags/*:refs/tags/*' OR git fetch <url of origin> --prune --prune-tags OR git fetch <url of origin> --prune 'refs/tags/*:refs/tags/*'
    – mkisaacs
    Sep 20, 2018 at 20:21
  • 12
    git fetch origin --prune --prune-tags prune both remote tracking branches and tags. checked in git 2.18 version.
    – Number945
    Sep 27, 2018 at 4:02
242

Looks like recentish versions of Git (I'm on git v2.20) allow one to simply say

git fetch --prune --prune-tags

Much cleaner!

https://git-scm.com/docs/git-fetch#_pruning

You can also configure git to always prune tags when fetching:

git config fetch.pruneTags true

If you only want to prune tags when fetching from a specific remote, you can use the remote.<remote>.pruneTags option. For example, to always prune tags when fetching from origin but not other remotes,

git config remote.origin.pruneTags true
5
  • Great one. I have adapted it to post on SOes -> ¿Cómo puedo eliminar las etiquetas de Git que solo tengo en local?.
    – fedorqui
    Aug 19, 2019 at 10:13
  • Excellent! I met git push failure with "git-shell died of signal 13". No effect even with the increased http.postbuffer. After enable GIT_TRACE_PACKET and GIT_TRACE, I saw pushing to invalid refs/tags so using "--prune-tags" resolve it. Thanks a lot!
    – Ivellios
    Mar 4, 2020 at 14:25
  • 4
    Can be written as git fetch -pP
    – pooya13
    Mar 19, 2021 at 17:32
  • Note that this will prune local branches too edit I'm on 2.19.2.windows.1 though Apr 7, 2022 at 9:20
  • 3
    git fetch --prune-tags didn't work. We have to prune branches alongside tags always? What if I don't want to prune branches? Thanks.
    – RTD
    Sep 8, 2022 at 11:11
196

If you only want those tags which exist on the remote, simply delete all your local tags:

$ git tag -d $(git tag)

And then fetch all the remote tags:

$ git fetch --tags
3
  • 4
    @ocroquette, I'm not sure how it's nicer than xargs. If you have more tags than ARG_MAX, or similar limitations, this won't work. Unlikely, but possible, and that's why xargs is great. Aug 25, 2015 at 15:08
  • 3
    "nice" is a subjective thing, everyone will make his/her own opinion. About ARG_MAX, that's true. However, on the systems I use, ARG_MAX is much higher than the number of tags I have in any repository, so I don't mind the limitation, just as I don't mind about it when I write "ls *.jpg".
    – ocroquette
    Aug 26, 2015 at 16:02
  • 3
    git config --global alias.prune-tags '!git tag -d $(git tag) && git fetch --tags' Obligatory alias command. Enjoy. :-) Aug 22, 2018 at 21:33
86

All versions of Git since v1.7.8 understand git fetch with a refspec, whereas since v1.9.0 the --tags option overrides the --prune option. For a general purpose solution, try this:

$ git --version
git version 2.1.3

$ git fetch --prune origin "+refs/tags/*:refs/tags/*"
From ssh://xxx
 x [deleted]         (none)     -> rel_test

For further reading on how the "--tags" with "--prune" behavior changed in Git v1.9.0, see: https://github.com/git/git/commit/e66ef7ae6f31f246dead62f574cc2acb75fd001c

3
  • 1
    Replaced origin with upstream and git corrected my local tags based on the upstream; next git push origin :<deleted-tag-name> updated my GitHub fork, removing the deleted tag.
    – leanne
    Sep 22, 2017 at 21:17
  • 3
    At least with git 2.18.0 one can also use this syntax: git fetch --prune --prune-tags origin
    – Martin
    Aug 7, 2018 at 14:28
  • 4
    Starting with git 2.17.0 - the --prune-tags option was included and described in the PRUNING section in detail with equivalent commands in the following document: git-scm.com/docs/git-fetch/2.17.0 git fetch origin --prune --prune-tags OR git fetch origin --prune 'refs/tags/*:refs/tags/*' OR git fetch <url of origin> --prune --prune-tags OR git fetch <url of origin> --prune 'refs/tags/*:refs/tags/*'
    – mkisaacs
    Sep 20, 2018 at 20:14
83

Good question. :) I don't have a complete answer...

That said, you can get a list of remote tags via git ls-remote. To list the tags in the repository referenced by origin, you'd run:

git ls-remote --tags origin

That returns a list of hashes and friendly tag names, like:

94bf6de8315d9a7b22385e86e1f5add9183bcb3c        refs/tags/v0.1.3
cc047da6604bdd9a0e5ecbba3375ba6f09eed09d        refs/tags/v0.1.4
...
2f2e45bedf67dedb8d1dc0d02612345ee5c893f2        refs/tags/v0.5.4

You could certainly put together a bash script to compare the tags generated by this list with the tags you have locally. Take a look at git show-ref --tags, which generates the tag names in the same form as git ls-remote).


As an aside, git show-ref has an option that does the opposite of what you'd like. The following command would list all the tags on the remote branch that you don't have locally:

git ls-remote --tags origin | git show-ref --tags --exclude-existing
3
  • 14
    Richard W's answer does this much more elegantly, in case you are not interested in a complicated script. Feb 11, 2013 at 19:28
  • 2
    The side note about tags not present locally can be expanded to check more remotes: git remote | xargs -L 1 git ls-remote --tags | git show-ref --tags --exclude-existing
    – Palec
    Jun 23, 2014 at 14:26
  • 2
    git supports --prune-tags. Uncertain what version this was introduced. git-scm.com/docs/git-fetch#git-fetch---prune-tags Oct 1, 2018 at 19:29
33

In new git versions (like v2.26.2 or higher) you could use --prune-tags

-P
--prune-tags
Before fetching, remove any local tags that no longer exist on the remote if --prune is enabled. This option should be used more carefully, unlike --prune it will remove any local references (local tags) that have been created. This option is a shorthand for providing the explicit tag refspec along with --prune, see the discussion about that in its documentation.

So you would need to run:

git fetch origin --prune --prune-tags
14

Git natively supports cleanup of local tags

git fetch --tags --prune-tags

This command pulls in the latest tags and removes all deleted tags

5
  • 1
    It seems it should be "--prune" instead of "--prune-tags", otherwise that's what I needed, thanks.
    – AnyDev
    Aug 17, 2018 at 7:39
  • I have getting issue in source tree failed to push some refs to... : It works for me :) Thanks Alot Aug 22, 2018 at 7:21
  • @AnyDev: --prune-tags is correct. The man page says about --prune: Tags are not subject to pruning if they are fetched only because of the default tag auto-following or due to a --tags option. May 13, 2021 at 13:26
  • 1
    This removes "any local tags that no longer exist on the remote if --prune is enabled". So it should be git fetch --tags --prune --prune-tags. This would also prune other refereces, but AFAIK there's no way to only prune tags. Anyway, the command in this answer did not work for me. (git version 2.32.0)
    – wovano
    Nov 10, 2021 at 14:45
  • This did not work for me. I had to prune away branches as well via git fetch --prune --prune-tags. My git version is 2.37.3. No sure if git fetch --tags --prune --prune-tags will skip pruning branches?
    – RTD
    Sep 8, 2022 at 11:14
12

I know I'm late to the party, but now there's a quick answer to this:

git fetch --prune --prune-tags # or just git fetch -p -P

Yes, it's now an option to fetch.

If you don't want to fetch, and just prune:

git remote prune origin
7

this is a good method:

git tag -l | xargs git tag -d && git fetch -t

Source: demisx.GitHub.io

5

Updated @2021/05

enter image description here

Pass $REPO parameter to custom script.

The content of sync_git_tags.sh

#!/bin/sh

# cd to $REPO directory
cd $1
pwd

# sync remote tags
git tag -l | xargs git tag -d && git fetch -t

Old

ps: updated @2021/05, git fetch --prune --prune-tags origin not working in my MacOS.

I add the command to SourceTree as a Custom Action on my MacOS.
Setting Custom Actions by Sourcetree -> Preferences... -> Custom Actions


`Script to run` have to be the `git` path.

I use git fetch --prune --prune-tags origin to sync tags from remote to local.

enter image description here enter image description here

1
  • Thanks! git tag -l | xargs git tag -d && git fetch -t works. Sep 17, 2021 at 0:48
5

The same answer as @Richard W but for Windows (PowerShell)

git tag | ForEach-Object -Process { git tag -d $_ }
git fetch -t
4

Show the difference between local and remote tags:

diff <(git tag | sort) <( git ls-remote --tags origin | cut -f2 | grep -v '\^' | sed 's#refs/tags/##' | sort)
  • git tag gives the list of local tags
  • git ls-remote --tags gives the list of full paths to remote tags
  • cut -f2 | grep -v '\^' | sed 's#refs/tags/##' parses out just the tag name from list of remote tag paths
  • Finally we sort each of the two lists and diff them

The lines starting with "< " are your local tags that are no longer in the remote repo. If they are few, you can remove them manually one by one, if they are many, you do more grep-ing and piping to automate it.

4
  • 2
    Please consider adding some explanation to your code. This would definitively improve the quality of your answer.
    – honk
    Oct 15, 2014 at 19:10
  • The complete command to delete all remote tags not present locally would then be: diff <(git tag | sort) <( git ls-remote --tags origin | cut -f2 | grep -v '\^' | sed 's#refs/tags/##' | sort) | grep ">" | cut -c3- | xargs -I{} git push origin :refs/tags/{} Sep 14, 2018 at 11:43
  • If you need to make such a diff and displaying the commit hash at the same time: diff <(git show-ref --tags | grep -v '{}' | awk '{print $1 " " $2}') <(git ls-remote --tags origin | grep -v '{}' | awk '{print $1 " " $2}')
    – piroux
    Mar 15, 2019 at 9:38
  • This comparison was exactly what I was looking for, thank you. The only thing I'm confused about is that it also outputs a couple of lines which don't start with an arrow <, but a number followed by a comma and then what looks like the first three characters of a commit hash (?), e.g. 7,8d4...
    – Kay
    Jul 14, 2019 at 11:47
3

Just added a git sync-local-tags command to pivotal_git_scripts Gem fork on GitHub:

https://github.com/kigster/git_scripts

Install the gem, then run "git sync-local-tags" in your repository to delete the local tags that do not exist on the remote.

Alternatively you can just install this script below and call it "git-sync-local-tags":


#!/usr/bin/env ruby

# Delete tags from the local Git repository, which are not found on 
# a remote origin
#
# Usage: git sync-local-tags [-n]
#        if -n is passed, just print the tag to be deleted, but do not 
#        actually delete it.
#
# Author: Konstantin Gredeskoul (http://tektastic.com)
#
#######################################################################

class TagSynchronizer
  def self.local_tags
    `git show-ref --tags | awk '{print $2}'`.split(/\n/)
  end

  def self.remote_tags
    `git ls-remote --tags origin | awk '{print $2}'`.split(/\n/)
  end

  def self.orphaned_tags
    self.local_tags - self.remote_tags
  end

  def self.remove_unused_tags(print_only = false)
    self.orphaned_tags.each do |ref|
      tag = ref.gsub /refs\/tags\//, ''
      puts "deleting local tag #{tag}"
      `git tag -d #{tag}` unless print_only
    end
  end
end

unless File.exists?(".git")
  puts "This doesn't look like a git repository."
  exit 1
end

print_only = ARGV.include?("-n")
TagSynchronizer.remove_unused_tags(print_only)
1

How about this - drop all local tags and then re-fetch? Considering your repo might contain submodules:

git submodule foreach --recursive  'git tag | xargs git tag -d'
(alternatively, "for i in `find .git  -type d -name '*tags*'`; do rm -f $i/*;  done")
git fetch -t
git submodule foreach --recursive git fetch -t
1

TortoiseGit can compare tags now.

Left log is on remote, right is at local.

enter image description here

Using the Compare tags feature of Sync dialog:

enter image description here

Also see TortoiseGit issue 2973

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.