Youtrack logo

The YouTrack Blog

The Issue Tracking and Project Management Tool for Teams

Features How-To's

Confluence Integration Is Here

If you’re using YouTrack and Confluence together, you might be interested in this little add-on that helps you integrate these two at some level.

The add-on brings two macros:

1. issue which simply inserts a link to any YouTrack issue, and this link reflects the issue state, so you can tell, for example, if the issue is resolved or not by just looking at a page. Here’s an example of its syntax:

{issue:id=DOC-3202}

And this is what it produces:

link to issue

Hovering mouse over this link gives a tooltip with even more details like assignee, number of votes, etc.This macro was inspired by our marketing team who are actively using Confluence pages to aggregate information about various tasks that are connected with YouTrack issues, so now they can just open a page and have a clear view of how things are going with this or that task at a glance.

2. report this one allows you to insert a report based on a YouTrack issue query to a Confluence page. For example, this creates a page that displays unresolved issues from the DOC project:

{report:project=DOC|query=#Unresolved}

report

Get the add-on now and start using YouTrack and Confluence together. We’ve just started developing the plugin, so if you have a feature request or other feedback, don’t hesitate to share it with us.

Comments below can no longer be edited.

36 Responses to Confluence Integration Is Here

  1. Avatar

    Ivan says:

    March 17, 2015

    Здравствуйте,
    При использовании плагина для построением отчета, кириллические символы отображаются с битой кодировкой. Скрин с конфлю – http://screencast.com/t/BRiAykCW1

    Версия развернутого Конфлю:
    Confluence 5.6.3

    Версия развернутого ЮТ:
    JetBrains Bug & Issue Tracker YouTrack 6.0
    Build 12619 18-Feb-2015 20:42

  2. Avatar

    Egor Malyshev says:

    March 17, 2015

    Это исправлено уже в версии 1.6.8.2

  3. Avatar

    Marcus Meyer says:

    March 19, 2015

    By now the addon is not available for the confluence cloud.
    Will that be changed in the near future?

  4. Avatar

    Marcus Meyer says:

    March 24, 2015

    Any update on confluence in the cloud and this plugin?

  5. Valerie Andrianova

    Valerie Andrianova says:

    March 24, 2015

    Hi Marcus,
    Unfortunately, it’s on the Atlassian side, they decide which add-ons to add to the cloud. We contacted them, asking to add our plugin to the cloud.

    • Avatar

      Nick Wade says:

      May 18, 2017

      This information is not correct. Developers have been able to publish add-ons for Atlassian’s cloud applications directly for quite some time. Please see https://developer.atlassian.com/explore-the-apis/ to understand how to bring your integration to Confluence Cloud if you have that as a priority for our joint customers.

      Thanks! -nick wade
      Head of Business, Atlassian Ecosystem

      • Avatar

        Egor Malyshev says:

        May 19, 2017

        Thanks a lot for this link, I will definitely look into this API.

        • Avatar

          Alexej Kubarev says:

          October 13, 2017

          Any updates on Confluence Cloud support?

          • Avatar

            Egor Malyshev says:

            October 13, 2017

            None so far.

  6. Avatar

    Frank says:

    April 2, 2015

    No matter how I configure your Confluence plugin, I always get this error:

     com.atlassian.renderer.v2.macro.MacroException: youtrack.exceptions.CommandExecutionException: Command failed: GetProject{itemId='JOO'} host parameter is null
    

    I successfully tested the rest API with the same user, password, and REST URL, and it works…

  7. Avatar

    Egor Malyshev says:

    April 2, 2015

    Which plugin version are you using?

    • Avatar

      Frank says:

      April 8, 2015

      Sorry for taking so long to get that info (I’m not Confluence admin myself): plugin version is 1.6.8.4

      • Avatar

        Frank says:

        April 8, 2015

        But my Confluence admin colleague just told me he tried all available plugin version, but none of them seems to work for us.

  8. Avatar

    Karl says:

    December 18, 2015

    Can’t get plugin to work. The user is correct, the API-Url seems to be fine as well, no logging entries. Getting “Cannot login to the specified YouTrack instance with credentials you provided.”

    • Avatar

      Karl says:

      December 18, 2015

      Sorry, forgot version information:
      Confluence 5.9.2
      Youtrack 6.0.12634

      Integration is NOT marked as compatible to be clear. I gave it a try anyway.
      Help would be appreciated.

      • Avatar

        Karl says:

        December 18, 2015

        oh, and the plugin version is 1.7.0.7

        • Avatar

          Egor Malyshev says:

          December 18, 2015

          Thanks for reporting this, I will look into what could go wrong.

        • Avatar

          Egor Malyshev says:

          December 18, 2015

          I just tried this with 5.9,2 and 1.7.0.7 worked just fine. Maybe you could contact me via mail or skype (egor.malyshev), and I’ll ask you a couple of questions about what possibly could go wrong?

  9. Avatar

    Hans says:

    October 20, 2016

    Does anyone have also problems to connect to confluence after updating to youtrack 7.0?

    Error!

    Cannot login to the specified YouTrack instance with credentials you provided.

    Settings have not been updated.

    #requireResource(“com.atlassian.auiplugin:aui-experimental-iconfont”)

    • Avatar

      Natasha Katson says:

      October 26, 2016

      Hi! Please contact out support youtrack-incloud-support@jetbrains.com and attach a screenshot from your console when you get this error. Thanks!

    • Avatar

      Egor Malyshev says:

      October 26, 2016

      If you’re 100% sure that YouTrack REST URL is correct, and that there are no typos in password/login, this error is most likely caused by the fact that SSL certificate required to connect to YouTrack is missing from JVM under which you’re running your Confluence instance. You need to import it and this should resolve the connection problem.

  10. Avatar

    Sergey says:

    October 21, 2016

    It’d be cool to have an ability to choose exact fields to display. AFAIU currently it shows Issue, State, Summary and Assignee. Are you going to add this ability?
    Thanks.

    • Avatar

      Egor Malyshev says:

      October 26, 2016

      So I’ve updated the plugin https://marketplace.atlassian.com/plugins/youtrack.integration.plugin/versions#b11075 and you can now use a very simple template to specify what fields you want in your report.

      Default template is: State:State,summary:Description,Assignee:Assigned to

      As you can see it’s comma-separated pairs, in which the first string is YouTrack field name, and the second string is what will be displayed in the table header for this field when report is generated.

      Just a few sample field names you might be interested in

      “summary”
      “numberInProject”
      “Subsystem”
      “projectShortName”
      “updaterName”
      “Type”
      “votes”
      “commentsCount”
      “links”
      “reporterFullName”
      “reporterName”
      “Assignee”
      “Priority”
      “resolved”
      “State”
      “updated”
      “created”
      “updaterFullName”
      “sprint”
      “attachments”

  11. Avatar

    Egor Malyshev says:

    October 26, 2016

    Sure, that sounds like a good feature. I’ll post here when it’s ready.

  12. Avatar

    Erkki says:

    May 25, 2017

    Is there possible to show comments (concated) from issue on report?

    • Avatar

      Egor Malyshev says:

      May 25, 2017

      Sure, I can add this functionality to the Report macro.

  13. Avatar

    Alexander says:

    September 11, 2017

    Is it possible to use this plugin with Confluence Cloud?

  14. Avatar

    Egor Malyshev says:

    October 13, 2017

    Not right now, but yeah, we have plans to support that, too.

    • Avatar

      Michael Bertelsen says:

      January 3, 2018

      Status?

    • Avatar

      Michael Bertelsen says:

      February 11, 2018

      Any idea when the integration with the cloud version of Confluence will be done?

      • Valerie Andrianova

        Valerie Andrianova says:

        February 12, 2018

        The set of plugins valid for Confluence Cloud is controlled by Atlassian. We’re investigating the ways to get the approval at the moment. Unfortunately, I cannot provide any estimation at the moment, but hopefully, we’ll have news within 1-2 months.
        Thanks for your patience!

  15. Avatar

    Michael Bertelsen says:

    December 1, 2017

    Please make the Confluence Cloud soon… We get pressure internally to switch to Jira instead of YouTrack because of the lag of integration between YouTrack and Confluence Cloud.
    If we just could get an estimated release date… Please

  16. Avatar

    Andrew Hastie says:

    May 7, 2019

    Any update on getting YouTrack integrated with Confluence Cloud service? Checked today and still no sign of cloud version on Atlassian’s portal

  17. Avatar

    Stefan Stolz says:

    January 10, 2020

    Are there any plans that the add-on will support Confluence 7.x?

    • Avatar

      Elena Pishkova says:

      January 30, 2020

      Hi Stefan, thank you for the question. We have fixed this yesterday. YouTrack currently supports all the Confluence 7.x versions, so please check it out!

Discover more