How to Create a Tag in Bitbucket

April 11, 2026·2 min read

In this article

Interactive demo
Step-by-step guide
FAQ

Made with Saltfish·Create your own

Here's how to create a tag in Bitbucket

Navigate to the Commits section using the left sidebar menu.
Locate the specific commit you want to tag from the commit history.
Click on the commit link to open its details page.
Look for the 'Create Tag' button in the Details section on the right panel.
Click the 'Create Tag' button to open the tag creation form.
Type your desired tag name in the tag name field.
Add an optional description to explain what this tag represents.
Click the 'Create Tag' button to finalize and save your new tag.

Ready to get started with
interactive demos?

Try for free

Frequently Asked Questions

What is the purpose of creating tags in Bitbucket?

Tags in Bitbucket serve as markers for specific commits in your repository's history, typically used to identify release versions or important milestones. They make it easy to reference and checkout specific points in your codebase without remembering complex commit hashes.

Can I create a tag for any commit in my repository?

Yes, you can create a tag for any commit in your Bitbucket repository, whether it's the latest commit or an older one. Simply navigate to the specific commit through the Commits section and follow the tag creation process.

Is the tag description required when creating a tag in Bitbucket?

No, the tag description is optional when creating a tag in Bitbucket. However, adding a description is recommended as it helps other team members understand the purpose or significance of the tagged commit.