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

[Daniel Temple]

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.

https://confluence.atlassian.com/bitbucket/connect-bitbucket-cloud-to-jira-cloud-applications-814190686.html

What am I misunderstanding or missing?

[Ana Retamal · Accepted solution]

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 :)

Ana

[Daniel Temple]

Thanks, that's what I was missing.

[Guillermo]

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?

[Guillermo]

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

[Shannara]

Please update documentation. There is no "add source code" option.

[Jay Grayson]

For anyone that runs across this post, this is how I was able to successfully link a BitBucket Server 5.14.1 project to a Jira 7.12.3 Project:

• From the Project Settings page (Projects from the Settings Cog at the Top Right)
• Select the project, in the list on the page that appears, that you wish to modify
• At the very bottom of the page, there is a section called Settings that contains a link to Configure Project Links
• After clicking that anchor, you will be able to configure the link to this project by clicking the Add Link (top right of empty list) and choosing the server that you wish to connect to
• For me, I chose BitBucket Server and was presented with a module that ask for the name or key
• If you start typing, you will see the list begin to populate with your BitBucket projects

I hope this helps someone.  I only have these versions of Jira and BitBucket.  I am not a heavy tester, I am just a user.  I will not be able to help much with the changes and different GUI options that Atlassian post each week.  :)

[joseff]

I've tried this operation with Bitbucket Server v5.12.0 but I haven't found the project link (aka. EntityLink).
Is it only available for versions of Bitbucket >= 5.14.1?

[Moritz Mair]

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.

[Moritz Mair]

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.

[Shannara]

Ah, looks like something has changed since your post from over a month ago.

There is no settings > find integrations > jira in bitbucket.

And there is no add item > repository in jira.

[Chris Romp]

Par for the course with Atlassian these days. Everything has dramatically changed and the documentation hasn't kept pace. I can't find a damn thing anymore. 😤

[Jay Grayson]

For anyone that runs across this post, this is how I was able to successfully link a BitBucket Server 5.14.1 project to a Jira 7.12.3 Project:

• From the Project Settings page (Projects from the Settings Cog at the Top Right)
• Select the project, in the list on the page that appears, that you wish to modify
• At the very bottom of the page, there is a section called Settings that contains a link to Configure Project Links
• After clicking that anchor, you will be able to configure the link to this project by clicking the Add Link (top right of empty list) and choosing the server that you wish to connect to
• For me, I chose BitBucket Server and was presented with a module that ask for the name or key
• If you start typing, you will see the list begin to populate with your BitBucket projects

I hope this helps someone.  I only have these versions of Jira and BitBucket.  I am not a heavy tester, I am just a user.  I will not be able to help much with the changes and different GUI options that Atlassian post each week.  :)

[Azfar Masut]

Im still confuse, what does this link do? I configured it, but I cant find any link to bitbucket project here in JIRA. Someone help me please? Thanks

[Rachel Lucas]

[Luis Lohmann]

This doesn't work for me. Only the shortcut option appears. :/

[Markus Iseli]

I just (Nov. 22, 2020) had the same issue: only the "shortcut" option showed.

Logging out and back into Atlassian account fixed the problem.

Seems to be a bug.

[skchinna7]

It is hard to connect the jira to bitbucket . but it is easy to connect the jira to github. and some articles are not helpful to me i don't see the settings which are mentioned in the text rather it should show me the image way which is the easiest way to understand the products very better way

[JEENI]

Hi there, I don't see the

"Add source code"

It says that I have successfully connected our BitBucket and our repo appears in the settings DVCS account and I can see and access them there but the still don't appear in the "Code <?>" view on the left of the project.

Any help would be much appreciated.

Thanks

Andi

[Markus Iseli]

Hi Andi,

This link explains it all - and it worked - at least for me:

https://support.atlassian.com/bitbucket-cloud/docs/use-jira-software-projects-in-bitbucket/

The section "Link a project to a repository manually" did the trick for me. In particular the following two steps: 

1. In your repository navigation panel, click Jira issues. In the issue list, select the folder icon located at the top right-hand side and click Manage linked projects.

1. In the dialog, select a project from the dropdown, then click Link project.

Hope this helped.

[Jay Grayson]

For anyone that runs across this post, this is how I was able to successfully link a BitBucket Server 5.14.1 project to a Jira 7.12.3 Project:

• From the Project Settings page (Projects from the Settings Cog at the Top Right)
• Select the project, in the list on the page that appears, that you wish to modify
• At the very bottom of the page, there is a section called Settings that contains a link to Configure Project Links
• After clicking that anchor, you will be able to configure the link to this project by clicking the Add Link (top right of empty list) and choosing the server that you wish to connect to
• For me, I chose BitBucket Server and was presented with a module that ask for the name or key
• If you start typing, you will see the list begin to populate with your BitBucket projects

I hope this helps someone.  I only have these versions of Jira and BitBucket.  I am not a heavy tester, I am just a user.  I will not be able to help much with the changes and different GUI options that Atlassian post each week.

[Azfar Masut]

Hey Jay,

After configuring above, what happened? I cant see any bitbucket project links within my JIRA project. Where is it located? In the create branch?

[dboroja]

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 

[Anuj Aggarwal]

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:

Issues

Releases

.

.

Add Item

Settings

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

Hope this helps.

[Dave Furlani]

I've followed all the steps I can find that match either comments above or the official doco (which has gaps and/or is out of date). This is not as simple as it could be with clear steps and examples like Atlassian used to provide. Anyway...

After following all those steps I have a link/shortcut to the repo, but not the Development Tools link at the bottom of the Nav bar, not the Create Branch and Create Commit options in the right hand panel on each issue view.

What are the steps in Jira Cloud that result in having those options/features available to all users in the project? This config is so much more frustrating than it needs to be. I assume it's pretty simple once you have/know the right steps