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

Question

I have cloned a remote Git repository to my laptop, then I wanted to add a tag so I ran

git tag mytag master

When I run git tag on my laptop the tag mytag is shown. I then want to push this to the remote repository so I have this tag on all my clients, so I run git push but I got the message:

Everything up-to-date

And if I go to my desktop and run git pull and then git tag no tags are shown.

I have also tried to do a minor change on a file in the project, then push it to the server. After that I could pull the change from the server to my Desktop computer, but there's still no tag when running git tag on my desktop computer.

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

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

4723

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

81,209
77
221
333

answered Mar 04 '11 at 15:40

Trevor

48,482
2
16
12

553

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
53

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

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
5

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
10

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

score 1428 · Answer 2 · edited Jun 26 '20 at 17:49

1428

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.

edited Jun 26 '20 at 17:49

einpoklum

102,731
48
279
553

answered Oct 18 '14 at 09:12

Ciro Santilli Путлер Капут 六四事

302,449
85
1,093
879

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
31

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 Путлер Капут 六四事 Jan 20 '16 at 19:44
3

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 295 · Accepted Answer · answered Oct 24 '12 at 14:43

295

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

answered Oct 24 '12 at 14:43

solgar

3,893
1
23
30

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

118

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

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

79

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

20,492
6
56
69

score 64 · Answer 6 · 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 51 · Answer 7 · answered Mar 04 '11 at 15:40

51

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

answered Mar 04 '11 at 15:40

Fernando Diaz Garrido

3,917
18
22

score 23 · Answer 8 · 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 20 · Answer 9 · 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 20 · Answer 10 · answered Dec 01 '21 at 09:48

20

Add a tag in your current branch

git tag tag_name

Check if it's created or not

git tag

Push in your remote origin

git push origin tag_name

answered Dec 01 '21 at 09:48

Raisul Islam

381
4
16

score 1 · Answer 11 · answered May 13 '21 at 17:21

1

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

2,081
2
24
29

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

11 Answers11

Push a Single Tag

Push All of Your Tags at Once

Linked

Related