Upsource + JIRA Integration

Did you know that you can integrate Upsource with JIRA? It’s super easy, and not only it’ll allow you to have links to JIRA issues in Upsource, you will be able to create JIRA issues straight from a code review page in Upsource.

Let’s say, I have a project called MyAwesomeProject with default settings in JIRA with the key MAP. Now, if I want to report an issue to that project from a code review, I need to open my Upsource project settings and specify very little: JIRA URL, admin credentials, and project key.


That’s it, you’re ready to report issues from a code review:


Upsource will automatically create an issue in JIRA:

You can even create issues from discussions:

Issues reported from Upsource will all have the same type. Which one? The one that you have on top of the list here (Issues → Issue Type Schemes):
You can reorder these types in JIRA settings, so that something else is on top, and then the issues reported by Upsource will have a different type.

The default types of issues are all suitable for Upsource, but if you want to have a customised issue type for Upsource issues, make sure it has following issue fields enabled: Reporter, Summary, and Description.

Depending on how much you have customised your JIRA instance, you may or may not need to fine-tune some settings to enable this integration. Feel free to check out our documentation.

Comments below can no longer be edited.

13 Responses to Upsource + JIRA Integration

  1. Avatar

    Yury V. Zaytsev says:

    November 2, 2015

    Would be cool if Redmine was supported as well!

  2. Avatar

    Jeffrey says:

    February 29, 2016

    Why does it require a 3 letter key? Our company only uses 2 letter keys, which are valid in JIRA

  3. Avatar

    Eric B. says:

    March 23, 2016

    Can the integration go the other direction, too? For example, in our current implementation with Crucible, JIRA has a section that list the associated reviews.

    Would that same capability be possible with Upsource?

    • Avatar

      Marcel says:

      April 14, 2016

      Is there something about this or an answer?

    • Avatar

      Artem says:

      April 14, 2016

      Are we going to to design and additional filed on Jira side to show corresponding Upsource reviews? Probably yes, if Jira guys don’t do it before.

      So far no estimates yet.

  4. Avatar

    Patrick says:

    April 13, 2016

    Sounds nice.

    Will it be possible to automatically create a review from a Jira issue when a certain status transition is triggered (i. e. from “in progress” to “in code review”)?

    And, will it be possible to trigger another status transition once that code review is marked as “accepted” in upsource (i. e. automatically set the linked ticket from a status like “in code review” to e. g. “in deployment”)

    Would of course require some config depending on the workflow, and would require a detection if the status has changed during review timespan (in that case, the manually altered ticket status should not be modified).

    • Avatar

      Artem says:

      April 14, 2016

      Not in the current version, but we would like to implement it in the nearest future. Please upvote/watch corresponding request – https://youtrack.jetbrains.com/issue/UP-5092

      • Avatar

        Patrick says:

        April 21, 2016

        Thank you for the pointer. I very much hope this will be implemented soon.

  5. Avatar

    Chris says:

    June 2, 2016

    I think in the newest version there is no link “Create issue” 🙁

    • Avatar

      Maria Khalusova says:

      June 2, 2016

      Hi Chris! It should be there. Can you please write an email to our support, so we could figure out what went wrong?

  6. Avatar

    Timur says:

    November 1, 2016

    Sorry, I didn’t get how to “have links to JIRA issues in Upsource”. I take it that it’s something more than just copy “http://JIRAADDRESS.com/browse/PROJ-9999” and paste in in comment? What’s exactly jira specific here?

    Would be nice if, f.e. when review’s being created from branch, it’s name would be parsed in search of PROJ-9999 and if it matches to some real existing ticket “http://JIRAADDRESS.com/browse/PROJ-9999” link to it automatically appears at the top of review (near the name of review or even inside it).

    Or is there some macro we can specify to mention some ticket and link to it will appear with some additional info, like confluence do it in atlassian?


  7. Avatar

    Ulli says:

    April 18, 2017

    We need to add multiple Jira projects for UpSource project …How to handle it

    • Valerie Andrianova

      Valerie Andrianova says:

      April 20, 2017

      Unfortunately, we don’t provide this ability at the moment. However, here is a feature request: https://youtrack.jetbrains.com/issue/UP-7813. Please watch it for the updates.

Discover more