How do I connect a Bitbucket repository with a Jira Cloud project?

I have followed the instructions to enable Bitbucket and JIRA integration in the Cloud, which all seems fine.

I was expecting to find a JIRA Project configuration allowing me to specify which Bitbucket repository(ies) were related to that project, or alternatively a Bitbucket repo configuration to point to a JIRA project.

But I can't find this anywhere, all I can see is (in JIRA) under DVCS accounts, a repository mentioned. But this is in the non-project specific configurations.

What am I misunderstanding or missing?

3 answers

1 accepted

2 votes

Hi Daniel!

In that case you might want to do it from the JIRA site. To link a project to a repository, select Projects in the top navigation bar and choose the JIRA project you want to connect to Bitbucket Cloud. Then choose Add source code and enter the URL of the repository. You can find this information at Connect JIRA Cloud to Bitbucket Cloud.

Hope this helps :)


Thanks, that's what I was missing.

It does not show up the "Add source code" for me. And I already added the Jira plugin in BitBucket. What else am I missing here?

@Ana Retamal Ortiz can you please update the documentation on how to do this? I cannot find the add source code either. Thanks

I can't find a "Add source code" or "Add repository" button in the suggested places. Has it moved again? I already connected Jira and Bitbucket.

Do we need to install an plugin for this? Something like "Git integration for Jira"

Thanks for your help. Maybe it would be helpful to keep documentation up to date or at least tell us when it was last updated.

So one month passed and we used Jira in the meantime.

There are two ways of linking your Jira and your Bitbucket project:

  1. via bitbucket account or team Settings -> Find integrations -> Jira
  2. in every Jira project Add Item -> Repository

First one will enable you to use commit messages like "IB-2 #done" which will link the commit to the issue IB-2 in Jira.

The second one just creates a link to your Bitbucket repo so you can just switch over to your bitbucket repo with one click.


And thats all integration there is that I could find.

Hello Ana, I am trying hard to find the location within the project that you are suggesting however, no luck. Could you be more specific or is there a white paper on how to connect JIRA project to a specific Bitbucket repo. .. I am running JIRA 7.5.3 (server) and Bitbucket Academic Cloud option. Thank you, Denis 

Hi Denis,

Unfortunately, documentation is not updated and I struggled as well to connect my repo with the JIRA project.

You have to find these options in the left navigation bar:





Add Item



Then, under Settings, you would find link to add repo.


Hope this helps.

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Posted Jun 12, 2018 in Bitbucket

Do you use any Atlassian products for your personal projects?

After spinning my wheels trying to get organized enough to write a book for National Novel Writing Month (NaNoWriMo) I took my affinity for Atlassian products from my work life and decided to tr...

23,629 views 26 12
Join discussion

Atlassian User Groups

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

Find a group

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

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you