Add tags to commits in Bitbucket

Git tags have become essential to a Git workflow to mark specific points in your Git history (such as referencing a specific version of a project by tagging a commit for release). They reduce complexity, clean up your branch workflow, and are a way to mark exact versions of confirmations. If you change versions a lot, they are a lifesaver for an organization rather than just using branches, which commonly leaves you with many branches that are rarely used.

Here’s a look at a hypothetical scenario for adding tags: You’re a release manager preparing for a release, so you navigate to the Bitbucket UI and see all the commits, looking for the one that has all the features you want to include and has step-by-step builds. You find the confirmation and realize that a launch tag is missing, so you go to the command line: create and submit the tag so you can tag the commit for the version, then go back to the Bitbucket UI to see the tag and ultimately do the release. This is a major pain (shakes fist when changing context).

Bitbucket users

have asked us how they can cut this back and forth and tag commits directly from the Bitbucket Cloud UI, and today we’re launching this capability to add annotated git tags and regular mercurial tags directly to commits from the UI. . The tag name, date/time, and author can be applied to any confirmation.

If you’re reading this thinking “why would someone tag a confirmation from the UI? The command line works well for me.” Let’s see where you can save time and find commits that need tagging in Bitbucket without switching to the command line


  • Branches page: Quickly check that all features scheduled for release have been merged into your parent branch, before creating your tag
  • .

  • Commit build status: Check the build status of your commit. If there is a failed build, you may want to make some corrections before creating your label.

Add tags from the Bitbucket UI

To add a tag, navigate to a commit in your repository and click the commit that a tag needs. In the details pane, on the right side of the confirmation view, you can see ‘current tags’ and ‘create tag’. Once ‘create tag’ is selected, the author and timestamp will be automatically recorded.

In the future, we will extend tagging from the UI with the ability to add custom messages to complement any annotated git tags applied in the UI. If you’re looking for lightweight tags, they can still be added through our API, but they’re not currently available in the UI.

Try tagging


If you’re already using Bitbucket, start saving time with this new feature and start tagging (everything). If you’re new to Bitbucket, sign up for a Bitbucket Cloud account, create a repository, and commit to trying it out. If you get stuck, more detailed labeling documentation is available here.

Get started, it’s free

Do you have more specific questions about this post? Contact us on Twitter to get the information you need