Use the JIRA DVCS Connector Add-on

You can connect Bitbucket Cloud or GitHub accounts with JIRA using the free JIRA DVCS Connector add-on. This add-on comes with JIRA Cloud.  For JIRA download users, this is a system add-on that you can install. Using the DVCS connector, you can: 

  • Link all or a subset of your existing repositories (both public and private) to JIRA.
  • Create new repositories and have them link automatically to JIRA.
  • Create new branches in a repository, and see those branches in the related JIRA issue.
  • Reference JIRA issues from a DVCS commit message and have those commits appear in the Development panel in the JIRA issues.
  • Create new pull requests from a JIRA issue, and see all the related PRs in a JIRA issue.
  • Transition issues through a JIRA Cloud workflow (for example, Close, Reopen, and so forth)  using smart commit messages.

For more details, see:

  1. Bitbucket repositories linked with JIRA. Any other DVCS provider accounts would be here as well.
  2. DVCS account link.
Notes and Tips
  • For JIRA download users, the latest version of the JIRA DVCS Connector is available for download from Atlassian Marketplace.
  • The Bitbucket links feature offers a similar functionality for JIRA  and other services.
  • If you want to report a new issue, provide feedback, or require help, please raise a request in the issue tracker for JIRA DVCS Connector project. 

Current known limitations of this feature

The following limitations exist for this feature:

  • There is no way to link user accounts on JIRA with user accounts on Bitbucket. This functionality will come with Atlassian account in the future.
    However, when you create JIRA users, emails will be automatically sent to the new users, inviting them to join Bitbucket. For details, see Managing Users.
  • If you use email addresses to connect Cloud with Bitbucket, repositories cannot be linked and you will see an error similar to the one shown in the screenshot below. To work around this, use your Bitbucket account name instead of email address. 


Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

37 Archived comments

  1. User avatar


    How does the plugin work with GitHub? We got the plugin working on JIRA side but on GitHub the issue keys are not rendered as links. Is there any configuration required for that to work?

    12 Sep 2012
    1. User avatar

      Justen Stepka [Atlassian]

      Issue key linking is a feature that is only available for Bitbucket.

      This is because Bitbucket allows repo owners to register custom regex parsers, which Bitbucket built specifically for the DVCS connector.

      12 Sep 2012
  2. User avatar

    Greg Sabo

    Does this connector support to ability to only watch specific github branches? For example, I want a commit containing "JRA-144 #resolve" to only resolve JRA-144 when it is merged into the master branch.

    17 Apr 2013
    1. User avatar

      Marcus Bertrand [Atlassian]

      Not at the moment. Please feel free to request enhancements at

      17 Apr 2013
  3. User avatar


    I have linked in Bitbucket to our JIRA account, but is it possible the commit comment shows as a COMMENT against the JIRA tasks?   Or is it possible that when a commit from BitBucket occurs, it goes into JIRA as a commit, but sends an email notification to the JIRA task project owner?   Thanks in advance 

    06 Jun 2013
    1. User avatar


      To display your commits on an issue's Commits tab, you need to enable Enabling DVCS smart commits and then use the tags appropriately in your commit message.

      Bitbucket allows a user to watch a repository for commits.  Users can configure Bitbucket to send email notifications when users commit a change to a repository. See Manage Inbox and email notifications for more information.

      06 Jun 2013
  4. User avatar



    I have a question regarding the Service Scheduler for the DVCS service. By default, the value is 60 min. Does that mean that any commit done to GitHub will be processed by JIRA in 60 mins maximum? I think the answer would be "no" as the plugin adds a POST commit hook to each repo, which means that as soon as a commit is done, it updates JIRA, right?

    In that case, what is the 60 min interval for in the Services page of JIRA? Is it the time needed to recognize a new repo? Or something else I am missing?


    24 Jun 2013
    1. User avatar

      Dusan Hornik [Atlassian]

      Hi Ismael,

      You are correct in everything.

      • As soon as the commit is done it updates JIRA via post commit hook.
      • Hourly service has two main purposes:
        1. backup mechanism to retrieve commits in case post commit hook is not working (not installed properly, JIRA is behind firewall, etc)
        2. discover new and deleted repositories
      24 Jun 2013
  5. User avatar


    Thank you Dusan!

    24 Jun 2013
  6. User avatar



    Is the DVCS connector plugin compatible with JIRA 6.0.3? I am having a look at the MarketPlace listing and it indicates that it is compatible up to JIRA 6.0 only.

    Do you know when it will be compatible with JIRA 6.0.3?


    08 Jul 2013
    1. User avatar


      Actually, I've installed JIRA 6.0.3 and the DVCS connector seems to be built-in this JIRA version. Is that right Dusan Hornik [Atlassian](wink)


      08 Jul 2013
  7. User avatar

    David Finney

    I just installed the JIRA DVCS Connector for Bitbucket and GitHub on my hosted JIRA instance. I was able to register the JIRA instance as an application with github. But from the JIRA add-on administration screeen when I go to add a new github account it is giving me the following error.

    Invalid user/team account.

    My account is 'oshehab'.

    22 Jul 2013
    1. User avatar


      If you signed up for Bitbucket on a hosted instance, they should have created the linked account for you.  Please contact for help with this.

      22 Jul 2013
      1. User avatar

        David Finney

        I am using a JIRA instance hosted on EC2. I am not interested about Bitbucket. I would like to connect JIRA with github.



        22 Jul 2013
        1. User avatar


          Sorry for the duh moment, support should still be able to help you.  

          22 Jul 2013
  8. User avatar

    James Millsap

    Anyone have problems with this in 5.1.4?  I installed and pointed it at our github, now it just pukes when I access the pluging....ala...


    I tried removing the plugin, and restart JIRA, then install fresh, but there must be a preference saved somewhere that is not getting removed.

    15 Aug 2013
    1. User avatar

      Marcus Bertrand [Atlassian]

      If you're having issues, please check our public forum at or directly to 

      20 Aug 2013
  9. User avatar

    Matt McClure

    Is there a way to navigate from JIRA to corresponding branches or pull requests in Bitbucket or GitHub? I want a way to see the aggregate changes of all the commits corresponding to a JIRA issue.

    20 Aug 2013
    1. User avatar

      Marcus Bertrand [Atlassian]

      Matt, see this issue I opened on your behalf in the DVCS Connector project  DCON-334 - Navigate from JIRA to branch or pull request Resolved

      20 Aug 2013
  10. User avatar


    I followed the instructions to integrate JIRA and BitBucket. I created a new project in JIRA and then added multiple Issues, Versions and components. After I enabled the integration, no issues appear in Bitbucket. Repo is bitbucket was created yesterday.


    BitBucket - Private issue tracker

    BitBucket - OAuthConsumer configured 

    JIRA DVCS is configured URL is empty, is this a problem.

    BitBucket - Integrated Applications: JIRA DVCS and Jira Importer Plugin

    JIRA -  Smart Commits is enabled in my repository

    03 Oct 2013
    1. User avatar


      Once you have the DVCS connector configured to work with Bitbucket, the workflow is:

      • Create an issue in JIRA.
      • Commit a change on repository and reference the JIRA issue in the commit message.
      • Push the change to Bitbucket.
      • The commit message appears in JIRA on the issue's Commits tab.

      Is this what you are expecting?

      04 Oct 2013
  11. User avatar

    David Shapiro


    I cannot connect to my github enterprise 11.10.302 version.  I get an error:

    Error obtaining access token. Response is invalid. Possibly bug in releases of GitHub Enterprise prior to 11.10.290

    The log shows:

    2013-10-18 11:01:14,585 http-bio-8080-exec-13 ERROR dashap 661x1641x1 ujuxal /secure/admin/AddGithubEnterpriseOrganization!finish.jspa [spi.github.webwork.GithubOAuthUtils] Requested access token response is invalid

    Any ideas?

    18 Oct 2013
    1. User avatar

      Marcus Bertrand [Atlassian]

      The community at or the JIRA Support team at may be able to help you resolve this issue. The documentation comments may not be viewed by the individuals that may be able to help you.

      18 Oct 2013
  12. User avatar


    Hey guys and galls you got to tell me what this is all about.All this reads as a site where users can login to a serve,it  is that right?What all you all are doing with this serve,somebody illuminates me please?


    10 Nov 2013
    1. User avatar


      Bitbucket is a hosted DVCS service. JIRA OnDemand is a hosted application in the cloud that you can pay-for monthly. The DVCS connector plugin allows you to commit code to Bitbucket and have that commit be tracked by JIRA as well.

      12 Nov 2013
  13. User avatar

    Laszlo Kremer

    Take care with DVCS configuration menu. I just clicked on it, JIRA slowed down really, and the whole DVCS plugin got disabled. Could not find much in the logs, but probably the plugin failed.

    11 Feb 2014
  14. User avatar

    Farye Nwede

    Is there a way to change the polling interval of a DVCS connect repository?  I would like to increase the frequency

    13 Feb 2014
    1. User avatar

      Marcus Bertrand [Atlassian]

      When the connector is configured, Bitbucket is also automatically configured to push the connector when your repository is updated. It should not be necessary at all to even use the poller as it should be kept up to date nearly instantly. If your configuration isn't doing this, then something may be misconfigured and we can help you fix that in support.

      13 Feb 2014
  15. User avatar

    Melvyn Sopacua

    Please update the security certificate for so we can vote.

    30 Mar 2014
  16. User avatar

    Eslam Mamdouh El Husseiny

    So how to link JIRA issues with github branches / commits / pull requests etc... ?

    03 Apr 2014
  17. User avatar

    Adam Stiskala

    It would be great if this feature was available for Git repositories hosted in Visual Studio Online. I have created a request for this at  DCON-456 - Support Visual Studio Online Git repositories Open  and the Visual Studio UserVoice.

    20 Aug 2014
  18. User avatar

    Francisco Cabrita


    Should I use this plugin to fetch projects (not code) from JIRA to Stash?

    The thing is: I've managed to install JIRA, Confluence and Stash, they look to work nice, Applink seems to work, I've also JIRA as central user directory and so on. I've imported the xml backups with success both on JIRA and Confluence (except didn't do anything about this on Stash).

    Now, I login to Stash and I don't see any project. How can I migrate them here?


    25 Sep 2014
  19. User avatar

    james young

    Is there a way to get the details that this connector adds to a ticket from the JIRA API?

    I have a ticket that has a branch and multiple commits that show up in JIRA, but when I query the API for the issue, I do not get any of the details for the commits.

    30 Sep 2014
  20. User avatar

    Jan Dockx

    OK, weird question.

    We have an on-site JIRA, with user management via an on-site Crowd. We connected the JIRA instance to Bitbucket via the JIRA DCVS Connector. We have several teams on Bitbucket (per client).

    What we see is that new users added to Crowd appear "magically" in a Bitbucket team's Developer role (invitation sent). This is annoying, as the new user is not related at all with the client the Bitbucket team works for.

    We haven't found any explanation for this weird behaviour yet.

    Just on the off chance: could this be a consequence of the JIRA DCVS connection?

    19 Jan 2015
    1. User avatar

      Dan Stevens [Atlassian]

      Hello Jan,

      This is likely because automatic invites are configured for the account you have connected, see Configure Automatic Team Invites for more information.

      To check for this in JIRA

      1. Log into JIRA with administrator permissions.
      2. Go to the Settings (the gear symbol)>Add-ons
      3. Click DVCS Accounts.
      4. Click the settings cog next to the Bitbucket account and select Configure automatic access
      5. Clear any selected box.

      If this doesn't resolve the problem feel free to contact support for JIRA or BItbucket.

      Happy coding,


      21 Jan 2015
      1. User avatar

        Jan Dockx

        Thx Dan!. This probably explains the mysterious behaviour.

        Can you point me to the documentation of this feature? I seem to have missed it, and I can't find it ...

        23 Jan 2015
  21. User avatar

    Joberto Diniz

    Hi, I have a question. We have 2 github accounts and 2 different projects, each project is belongs to one of the github account. How can we setup an account for a particular project?

    26 Jun 2015
Powered by Confluence and Scroll Viewport