3448

I added a tag to the master branch on my machine:

git tag mytag master

How do I push this to the remote repository? Running git push gives the message:

Everything up-to-date

However, the remote repository does not contain my tag.

0

13 Answers 13

5631
+50

To push a single tag:

git push origin <tag_name>

And the following command should push all tags (not recommended):

# not recommended
git push --tags
7
  • 662
    I recommend not using or training others to use git push --tags as it can be very very difficult to get rid of bad tags when your co-workers are trained to push all tags, as people continue to push the old bad tags they have locally every time they want to push a new tag. Because of this, I will only every advise someone to use git push origin <tag_name> now. Sep 25, 2014 at 23:47
  • 72
    To push a moved tag: git push origin <tag_name> --force
    – Bob Stein
    May 25, 2015 at 18:45
  • 34
    If your tag is the same as remote branch and git push fails with error: src refspec <tag_name> matches more than one., you can push it as git push origin tag <tag_name> Dec 10, 2015 at 6:13
  • 9
    Note that git push --tags origin <tag_name> IS NOT what you want - despite naming a specific tag, it pushes them all, even lightweight ones. Sigh.
    – nealmcb
    Nov 1, 2017 at 0:58
  • 19
    If you want to push all tags, you could first git push --dry-run --tags origin to see what will get pushed.
    – axxis
    Jul 15, 2019 at 15:46
1563

git push --follow-tags

This is a sane option introduced in Git 1.8.3:

git push --follow-tags

It pushes both commits and only tags that are both:

  • annotated
  • reachable (an ancestor) from the pushed commits

This is sane because:

It is for those reasons that --tags should be avoided.

Git 2.4 has added the push.followTags option to turn that flag on by default which you can set with:

git config --global push.followTags true

or by adding followTags = true to the [push] section of your ~/.gitconfig file.

Visual Studio Code

To activate this in Visual Studio Code set the variable "git.followTagsWhenSync": true on a user or workspace basis. GitHub

5
  • 1
    It was not clear at once for me that it was an and-relation between "annotated" and "reachable from the pushed commits". I hoped it would push all reachable tags, whatever if annotated or not. Maybe edit to make sure it's not an OR?
    – Gauthier
    Jun 11, 2015 at 13:00
  • 40
    This doesn't work for me in git 2.5.0, but git push origin --tags does.
    – nnyby
    Jan 20, 2016 at 19:35
  • @nnyby please provide a minimal example with all necessary commands from repo creation to failure and post it on a gist so I can try to reproduce ;-) Jan 20, 2016 at 19:44
  • 4
    Thanks for the push.followTags tip. I can't believe this isn't the out-of-the-box default. Without it, don't even bother to tag, you'll forget and get out of sync tags.
    – moodboom
    May 2, 2016 at 22:38
  • Added a line about setting the follow-tags through the config file.
    – einpoklum
    Jun 26, 2020 at 17:50
343

To push specific, one tag do following git push origin tag_name

0
126

To expand on Trevor's answer, you can push a single tag or all of your tags at once.

Push a Single Tag

git push <remote> <tag>

This is a summary of the relevant documentation that explains this (some command options omitted for brevity):

git push [[<repository> [<refspec>…]]

<refspec>...

The format of a <refspec> parameter is…the source ref <src>, followed by a colon :, followed by the destination ref <dst>

The <dst> tells which ref on the remote side is updated with this push…If :<dst> is omitted, the same ref as <src> will be updated…

tag <tag> means the same as refs/tags/<tag>:refs/tags/<tag>.

Push All of Your Tags at Once

git push --tags <remote>
# Or
git push <remote> --tags

Here is a summary of the relevant documentation (some command options omitted for brevity):

git push [--all | --mirror | --tags] [<repository> [<refspec>…]]

--tags

All refs under refs/tags are pushed, in addition to refspecs explicitly listed on the command line.

4
  • The example is leaving out the keyword tag. e.g. git push origin tag funny-tag-1. Dec 24, 2015 at 3:19
  • 1
    @JamesThomasMoon1979 You don't need it. You push a single tag to origin like this: git push origin my-tag (I just tried it!)
    – Andres F.
    Nov 11, 2016 at 15:14
  • I was using version 1.9.1, what about you @AndresF. ? Nov 14, 2016 at 20:45
  • 1
    @JamesThomasMoon1979 Version 2.10.2. Maybe that's it?
    – Andres F.
    Nov 14, 2016 at 21:01
114

Add a tag in your current branch. If you want to create the tag for your master, first check out to master.

git tag tag_name

Check if it's created or not

git tag

Push in your remote origin

git push origin tag_name
89

You can push all local tags by simply git push --tags command.

$ git tag                         # see tag lists
$ git push origin <tag-name>      # push a single tag
$ git push --tags                 # push all local tags 
70

Tags are not sent to the remote repository by the git push command. We need to explicitly send these tags to the remote server by using the following command:

git push origin <tagname>

We can push all the tags at once by using the below command:

git push origin --tags

Here are some resources for complete details on git tagging:

http://www.cubearticle.com/articles/more/git/git-tag

http://wptheming.com/2011/04/add-remove-github-tags

55

You can push the tags like this git push --tags

1
  • 7
    Very unrecommended
    – Tomer Gal
    Oct 25, 2022 at 10:38
27

How can I push my tag to the remote repository so that all client computers can see it?

Run this to push mytag to your git origin (eg: GitHub or GitLab)

git push origin refs/tags/mytag

It's better to use the full "refspec" as shown above (literally refs/tags/mytag) just in-case mytag is actually v1.0.0 and is ambiguous (eg: because there's a branch also named v1.0.0).

22

I am using git push <remote-name> tag <tag-name> to ensure that I am pushing a tag. I use it like: git push origin tag v1.0.1. This pattern is based upon the documentation (man git-push):

OPTIONS
   ...
   <refspec>...
       ...
       tag <tag> means the same as refs/tags/<tag>:refs/tags/<tag>.
0
8

push tag to remote

git push origin mytag

fetch all tags from remote

git fetch --all --tags
3

I did something like this :

git push --tags origin <branch-name> <tag-name>

e.g. : git push --tags origin master v2.0
3

In my case I am using Git version 2.30.0 I tried both --follow-tags and --tags, but both of them didn't work to push all the tags to the remote repo. I ended up using:

+refs/remotes/origin/tags/*:refs/tags/*

So for those who are looking for a way to push all the tags (along with master) to a remote repo, you can just add the following +refs/remotes/origin/tags/*:refs/tags/* to your push command.

So your command should be something like this:

git push path/to/your/repo +refs/remotes/origin/tags/*:refs/tags/*

It will successfully create all your tags in the remote repo.

4
  • Why overcomplicate life mate
    – Mehdi
    Jun 21, 2023 at 10:19
  • 1
    @Mehdi how is that? It's just the command I used in my case when we are unable to push tags to a remote, in my cas that was the unique way to do it.
    – cнŝdk
    Jun 21, 2023 at 11:16
  • That was not the question though
    – Mehdi
    Jun 21, 2023 at 19:46
  • 1
    Yes, maybe but it's worthy posting it, as I said it's for for those who struggle to push all their tags to a remote. It might be helpful for someone else.
    – cнŝdk
    Jun 22, 2023 at 11:00

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