Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Can I link Bitbucket Cloud Tags to Jira Cloud Versions

When I make a software release in Bitbucket I put a tag on the commit.  I know I can link a commit to a Jira issue if I include the Jira issue code in my Bitbucket commit.  My question is can I link a Bitbucket tag for a release to my Versions in a Jira project?


2 answers

3 votes
Ana Retamal Atlassian Team Dec 21, 2017

Hi Kathy, I'm afraid that's not possible, you can only link Jira issues and Bitbucket commits.

However, there are other actions you can do. For example, it is possible to transition a Jira issue to the next step in the workflow by entering a certain line in a Bitbucket commit. To learn more about this, you can read Processing Jira Software issues with Smart Commit messages.

Let us know if you have any questions!

Best regards,


Ana, thanks for the feedback on this.

As your answer was a while ago, could you advise whether this feature this is now available or is up for future consideration?

Ana Retamal Atlassian Team Aug 19, 2019

Hi Jan,

As far as I know, this feature is still not available. I've checked the issue tracker and seems like none of the users had logged it there, so there's no information whether this feature will ever be implemented. If you're interested in this, please go ahead and submit this request via our portal. It often helps to add some example of how this could benefit your work, so the developers understand the importance of the feature. 

Hope that helps!


Hi Jan, 

Very sad as this seems to be a useful link into bitbucket. Any alternatives? 



Like # people like this

Yes, it'd be nice if this feature was part of the Jira-Bitbucket integration "out-of-the-box", but I'm guessing Atlassian will never implement this since this functionality has no feature request and is entirely possible, and not very hard, to implement using these products' REST APIs. Releases are typically made only after a vetting process. These days it is standard protocol for this process to be implemented in a CI system which builds and tests your product on SCM events (pushing a commit or tag). 

So, I would propose the following solution (which is just one of many possible approaches) to your problem:

  1. Configure your CI system to build tags, and to be cognizant of when the build was initiated by a release tag. (Should be able to set up a release tag convention and set up your CI system, e.g. Jenkins git plugin, to filter on specific tag regex.)
  2. Modify your CI pipeline to inspect the build reason, and conditionally on successful build and test of release tagged builds, invoke the Jira rest API for creating and/or releasing a version (with same name as tag) in the corresponding Jira project.

After this work, your release process looks like this:

  1. Create a release tag in Bitbucket repo

What if the build/test fails? The corresponding Jira version is not released, as you would want.

To handle this, I propose that you leave the pipeline logic alone (keeping it simple "is this a build of a release tagged commit?) and move the release tag to the next commit after you fix the thing that caused the release build to not pass.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Bitbucket

New improvements to user management in Bitbucket Cloud 👥

Hey Community! We’re willing to wager that quite a few of you not only use Bitbucket, but administer it too. Our team is excited to share that we’ll be releasing improvements throughout this month of...

3,741 views 10 16
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you