How do you push a tag to a remote repository using Git?

Question

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.

score 5399 · Answer 1 · edited Jul 27 '21 at 14:45

5399

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

edited Jul 27 '21 at 14:45

700 Software

85,281
83
234
341

answered Mar 04 '11 at 15:40

Trevor

55,264
2
18
12

633

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 ` now. – Scott Jungwirth Sep 25 '14 at 23:47
68

To push a **moved** tag: `git push origin --force` – Bob Stein May 25 '15 at 18:45
30

If your tag is the same as remote branch and `git push` fails with `error: src refspec matches more than one.`, you can push it as `git push origin tag ` – Volodymyr Sapsai Dec 10 '15 at 06:13
7

Note that `git push --tags origin ` **IS NOT** what you want - despite naming a specific tag, it pushes them all, even lightweight ones. Sigh. – nealmcb Nov 01 '17 at 00:58
15

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 '19 at 15:46
`git push origin ` not worked for me. `git push origin refs/tags/`works. – user2027712 Sep 16 '22 at 02:34

score 1511 · Answer 2 · edited Jun 30 '23 at 08:56

1511

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:

you should only push annotated tags to the remote, and keep lightweight tags for local development to avoid tag clashes. See also: What is the difference between an annotated and unannotated tag?
it won't push annotated tags on unrelated branches

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

edited Jun 30 '23 at 08:56

theking2

2,174
1
27
36

answered Oct 18 '14 at 09:12

Ciro Santilli OurBigBook.com

347,512
102
1,199
985

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 '15 at 13:00
34

This doesn't work for me in git 2.5.0, but `git push origin --tags` does. – nnyby Jan 20 '16 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 ;-) – Ciro Santilli OurBigBook.com Jan 20 '16 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 02 '16 at 22:38
Added a line about setting the follow-tags through the config file. – einpoklum Jun 26 '20 at 17:50

score 329 · Accepted Answer · answered Oct 24 '12 at 14:43

329

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

answered Oct 24 '12 at 14:43

solgar

4,312
2
26
30

score 127 · Answer 4 · edited May 23 '17 at 12:10

127

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.

edited May 23 '17 at 12:10

Community

1
1

answered Apr 22 '14 at 10:52

The example is leaving out the keyword `tag`. e.g. `git push origin tag funny-tag-1`. – JamesThomasMoon Dec 24 '15 at 03: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 '16 at 15:14
I was using version *1.9.1*, what about you @AndresF. ? – JamesThomasMoon Nov 14 '16 at 20:45
1

@JamesThomasMoon1979 Version `2.10.2`. Maybe that's it? – Andres F. Nov 14 '16 at 21:01

Raisul Islam · Answer 5 · 2022-12-01T10:55:28.013

92

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

edited Dec 01 '22 at 10:55

answered Dec 01 '21 at 09:48

Raisul Islam

1,161
1
9
18

Sajib Khan · Answer 6 · 2019-06-21T02:19:22.397

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

edited Jun 21 '19 at 02:19

answered Nov 25 '16 at 08:15

Sajib Khan

22,878
9
63
73

score 68 · Answer 7 · answered Jan 10 '16 at 05:57

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

score 55 · Answer 8 · answered Mar 04 '11 at 15:40

55

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

answered Mar 04 '11 at 15:40

Fernando Diaz Garrido

3,995
19
22

4

Very unrecommended – Tomer Gal Oct 25 '22 at 10:38

score 27 · Answer 9 · answered Jul 29 '20 at 15:15

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).

score 22 · Answer 10 · answered Apr 18 '18 at 18:24

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>.

score 8 · Answer 11 · answered Oct 27 '22 at 07:06

8

push tag to remote

git push origin mytag

fetch all tags from remote

git fetch --all --tags

answered Oct 27 '22 at 07:06

Ali80

6,333
2
43
33

score 3 · Answer 12 · answered May 13 '21 at 17:21

3

I did something like this :

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

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

answered May 13 '21 at 17:21

Alferd Nobel

3,185
2
30
35

score 2 · Answer 13 · answered Mar 30 '23 at 14:28

2

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.

answered Mar 30 '23 at 14:28

cнŝdk

31,391
7
56
78

Why overcomplicate life mate – Mehdi Jun 21 '23 at 10:19
@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 '23 at 11:16
That was not the question though – Mehdi Jun 21 '23 at 19:46
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 '23 at 11:00

How do you push a tag to a remote repository using Git?

13 Answers13

Visual Studio Code

Push a Single Tag

Push All of Your Tags at Once

push tag to remote

fetch all tags from remote

Linked

Related