GIT-RENAME-TAG(1)

📦
version 7.5.0 · 7 versions
, in ubuntu stonking

✨ NAME ✨

git-rename-tag — bestie, it renames a tag 💅 (this one lives in the Git Extras collection, just so you know where to find it)

🦋 SYNOPSIS 🦋

git-rename-tag <old-tag-name> <new-tag-name>

💖 DESCRIPTION 💖

Rename a tag. That's it. That's the whole vibe. ✨

Oh and also — it does it locally and remotely, so no awkward "wait why is only my laptop aware of this" moment. It's giving thorough. 🫶

🌸 OPTIONS 🌸

  • <old-tag-name> — the name of the tag you want to rename. Like, the one it is right now. The before pic. 📸
  • <new-tag-name> — the new name of the tag. The glow-up name. The after pic. 👑

🎀 EXAMPLES 🎀

Okay so here's the whole saga, start to finish, no cuts 🍿

Making a tag and yeeting it to the remote:

$ git tag test
$ git push --tags
Total 0 (delta 0), reused 0 (delta 0)
To git@myserver.com:myuser/myrepository.git
 * [new tag]         test -> test
$ git tag
test

Now the rename itself. Watch it delete the old one and pop the new one into existence, iconically:

$ git rename-tag test test2
Deleted tag 'test' (was 1111111)
Total 0 (delta 0), reused 0 (delta 0)
To git@myserver.com:myuser/myrepository.git
 * [new tag]         test2 -> test2
remote: warning: Deleting a non-existent ref.
To git@myserver.com:myuser/myrepository.git
 - [deleted]         refs/tag/test

And the grand finale — look at the tag list now:

$ git tag
test2
Not the remote: warning: Deleting a non-existent ref. line just casually showing up mid-glow-up 😭 it's in the example exactly like that, no cap, we do not edit the lore.

🧚 AUTHOR 🧚

Written by Jesús Espino <jespinog@gmail.com> 💜

💀 REPORTING BUGS 💀

Found something cursed? Tell the humans here: <https://github.com/tj/git-extras/issues> 🐛

🌈 SEE ALSO 🌈

<https://github.com/tj/git-extras> — go look, it's lowkey a whole ecosystem 🌸

okay bestie that's the whole page, you're officially tag-renaming literate, main character energy achieved 👑 this was GIT-RENAME-TAG(1) from the Git Extras manual, dated May 2026 — go forth and rename responsibly, mwah 💖

📦 where this page comes from