Search the Confluence 4.1.x Documentation:

Index
Downloads (PDF, HTML & XML formats)
Other versions

This documentation relates to Confluence 4.1.x
If you are using an earlier version, please view the previous versions of the Confluence documentation and select the relevant version.
Skip to end of metadata
Comment: Corrected links that should have been relative instead of absolute.
Go to start of metadata

Please refer to the guide to Installing Confluence and JIRA Together.

JIRA and Confluence are designed to complement each other. Collect your team's thoughts, plans and knowledge in Confluence, track your issues in JIRA, and let the two applications work together to help you get your job done.

Below are some ways you can get JIRA and Confluence working together.

On this page:

(warning) The information on this page does not apply to Confluence OnDemand.

 

Setting Up Trusted Communication between JIRA and Confluence

An administrator can configure JIRA (3.12.0 or later) and Confluence to communicate in a trusted way, so that Confluence can request information from JIRA on behalf of the currently logged-in user. JIRA will not ask the user to log in again or to supply a password.

Trusted communication is used when embedding information from one application (for example, a list of JIRA issues) into another application (for example, a Confluence page).

Read more about trusted communication.

Inserting JIRA issues

You can insert issues from a JIRA site onto your Confluence page using the 'Insert JIRA Issue' dialogue box. You can also use this dialogue box to create a new issue on the JIRA site. See Inserting JIRA Issues.

Combining Confluence Shortcuts and JIRA Quick Search

In our Confluence site's global configuration (Administration > Shorcut Links) we have the following shortcut defined:

JIRA: http://jira.atlassian.com/secure/QuickSearch.jspa?searchString=

Use the above option to create links using Confluence's shortcut notation.

  • Link directly to JIRA issues like this: CONF-1000
  • Use JIRA's quick-search functionality to create links to particular groups of issues. The following link will display a list of all open issues in the Confluence project of type 'Improvement': CONF open improvements

Viewing Confluence Content in JIRA or JIRA Content in Confluence

Using Gadgets

You can embed a Confluence activity stream or a Confluence page in JIRA's dashboard. Likewise, JIRA gadgets can be rendered on a Confluence page. See Adding a Confluence Gadget to a JIRA Dashboard and Gadget Macro for information on how to set up gadgets.

Using the JIRA Issues macro

For versions earlier than Confluence 3.1 and JIRA 4.0, use the {jiraissues} and {jiraportlet} macros to embed JIRA reports and portlets into your Confluence site

Any JIRA search result can be embedded in a Confluence page using the JIRA Issues macro with your choice of included fields and field ordering, and any JIRA dashboard portlet can be embedded in a Confluence page using the JIRA Portlet macro.

Integrating JIRA and Confluence User Management

To save you having to enter users into both JIRA and Confluence, you may benefit from using Atlassian Crowd as the user repository for both applications. Alternatively you can configure Confluence to use JIRA's user database. See Connecting to Crowd or JIRA for User Management.

Useful Plugins

Before installing a plugin into your Confluence site, please check the plugin's information page to see whether it is supported by Atlassian, by another vendor, or not at all. See our guidelines on plugin support.

  • The JIRA Linker plugin provides a custom field that helps you find an URL, particularly a Confluence page, so you can add a page link into a JIRA issue.

48 Comments

Hide/Show Comments

  1. Apr 04, 2005

    Adam Reynolds

    Is there any news on JIRA and Confluence being able to 'log-in' to one another so that they can trackback and automatically create links to each other yet? We're evaluating the latest version of JIRA Enterprise and Confluence.

  2. Jun 28, 2005

    Anonymous

    I'd like to see trackback working for protected pages as well. Please update us! (smile)

  3. Aug 15, 2005

    Anonymous

    Is there any way to utilize the project categories and projects in JIRA to produce spaces and pages in Confluence? Can Confluence and JIRA use the same project database? It would be nice to set up a project in JIRA, and have a project space set up in Confluence automatically.

    1. Aug 15, 2005

      Tom Davies

      There's no way of doing this at the moment.

    2. Sep 08, 2010

      Anonymous

      I have just spent an hour trying to figure out how to do this... and then if it was even possible.

      It would be nice if JIRA would auto-generate pages or at least templates based on the creation of projects, components, and issues.

    3. Apr 20, 2011

      Anonymous

      We have a system that helps do this.  Although this involves a hybrid Atlassian / Drupal setup, whereby confluence spaces and user groups are created by the atlassian-CLI tool, using a set of scripts triggered by Drupal's Rules module.  Basically, when a Drupal organic group is created, the script creates a corresponding wiki space and user/admin group, as well as assigning the new space permissions to those groups.  New users that join the drupal group are automatically added to the atlassian user groups as well.   

      So it is possible, although a bit of a hack at the moment.  We're still figuring out how to apply this to Jira, but it works pretty flawlessly for Confluence at the moment.  

  4. Nov 10, 2005

    Willie Doyle

    I would really like to see you add trackback for authenticated installations. We have to have people login for various reasons. Is this currently slated for development?

  5. Mar 10, 2006

    Dimitry Voytenko

    Is there an easy way of combining Confluence and Jira together? I.e. I'm looking for "feature A" and get:

    Confluence matches:

    1

    2

    ...

    more

    Jira matches:

    1

    2

    ...

    more

    thanks,

    Dimitry

    1. Mar 15, 2006

      Matt Ryall (Atlassian)

      There are two outstanding feature requests that cover this functionality: CONF-2689, CONF-1436.

  6. Jan 25, 2007

    chenmin

    when I written a shortcut like:

    [PRJNAME+open+Tasks@jira], I got a link:   http://192.168.0.2:8080/secure/QuickSearch.jspa?searchString=PRJNAME%2Bopen%2BTask , so I can't get any result .

    I think the correct link should be:  http://192.168.0.2:8080/secure/QuickSearch.jspa?searchString=PRJNAME+open+Task

    Could you tell me how to write the shortcut to get a right link,

    Regards

    Matt Chen

    1. Jan 25, 2007

      Mei Yan Chan

      Hi Chenmin,

      Please try the following parameter:

      PRJNAME open Tasks

      Note that the additional '+' sign is substituted by a 'space' as the browser will interpret it for you. I have tried it both with Firefox and IE and they work perfectly. Please give that a go and let me know how it goes. Thanks.

      Regards,
      Mei

      1. Jan 25, 2007

        Mei Yan Chan

        A clearer parameter (the above is 'macroed') (smile)

        [PRJNAME open Tasks@jira]

        Regards,
        Mei

        1. Jan 29, 2007

          chenmin

          It really works~!

          Thank you very much~

        2. Aug 28, 2007

          Kari Sutela

          How would I define a link to a "free text" search with e.g. two words both appearing in a text box? For example, writing "web+integration" in the jira quick search box works fine, but I cannot find a way to define a corresponding link in Confluence.

          I have tried [PRJNAME web+integration@jira], [PRJNAME web integration@jira] etc with no luck.

          1. Aug 28, 2007

            Kari Sutela

            Found it! Underscore appears to work: [PRJNAME web_integration@jira]

  7. Jul 17, 2007

    Jacy Legault

    Is there a way to link from Jira to a specific version (historic) of a page in confluence? I noticed that confluence creates new pageids for older pages, which are stable once they have been made historic.

    1. Jul 18, 2007

      Fennie Ng

      Hi Jacy,

      Could you please elaborate more on how you want to link a Confluence page from Jira? As I know, there is a Jira Linker Plugin for Jira custom field to link with Confluence page. Would that plugin be of help?

      Regards,

      Fennie.

  8. Aug 04, 2007

    Sasha Zucker

    It should be noted that to use the Jira Linker Plugin, you currently have to grant anonymous access to the spaces on confluence that you want the plugin to be able to search. For organizations that are using confluence to store proprietary information, this requirements is unacceptable.

    Please add a note to this effect so that administrators don't spend hours trying to figure out how to get the plugin to work only to find out at the end that the plugin has unacceptable requirements. 

  9. Sep 21, 2007

    Ki Alam

    The Linker Plugin's need for Anonymous RPC access has made it untenable. 

    our developers would like to link to confluence pages more simply in the comment section of issues/subtasks:

    [wiki:space:page]

    It would be cool to have a list of external wikis (confluence1, confluence2) in the admin section so that something like this would work.

    1. Sep 23, 2007

      Mei Yan Chan

      Hi Ki,

      Thanks for your suggestion. I would advise you to create an issue ticket at our issue tracking system:

      Feel free to get back to me if you need further assistance. Thank you.

      Regards,
      Mei

  10. Nov 19, 2007

    Joshua Goodall

    Embedding the password is a huge no-no in most environments.

    Looking forward to http://jira.atlassian.com/browse/JRA-13727 in 3.12!

    1. Dec 11, 2007

      Sarah Maddox [Atlassian Technical Writer]

      Hi Joshua
      With Confluence 2.7 and JIRA 3.12, this should be good to go (smile)
      Cheers – Sarah

  11. Jul 15, 2009

    Jay Sellers

    I've enabled trackback in both jira and confluence. I added the JiraLinker plugin and created a custom field. When I choose a page in confluence to link to my jira task, that works great. But when I go to my confluence page, I see nothing saying that a link from jira exists. Do I need to put any wiki formatting in to see this in the page? I don't see it listed in the Page Info either.
    Thanks!
    -Jay

    1. Jul 28, 2009

      Azwandi Mohd Aris [Atlassian]

      Hi, Jay. I am afraid that the plugin itself does not send out a trackback to Confluence. You might be interested in the following feature request, however.

      Cheers,
      Azwan

  12. Jan 14, 2010

    Anonymous

    When we make the links via the shortcuts, it is rendered as an ugly hyperlink to 'CONF-1000@JIRA'.

    Does pretty printing so the link reads just 'CONF-1000' come with only newer versions of Confluence?

    We have Jira 4.0.1 and Confluence 2.10.2 (yes, very old, an upgrade is planned).

    Thanks.

    1. Jan 25, 2010

      Azwandi Mohd Aris [Atlassian]

      Hi, there. I have confirmed that this behaviour is unchanged in Confluence 3.1 (latest release). If you are keen on it, feel free to raise an improvement request in our issue tracker. Also, learn how we approach new implementation in our products.

      1. Mar 16, 2010

        Anonymous

        I would like to know how this page does it then.

        Looking at the wiki source for this page above given the example

        "Link directly to JIRA issues: CONF-1000"

        wiki source:

        Link directly to JIRA issues: \[CONF-1000@JIRA\]

        How can I get this functionality in Confluence 3.1? Can I run 3.2-rc1?

  13. Feb 08, 2010

    Anonymous

    I think it a huge misnomer to talk about any "Integration" between JIRA and Confluence.  Why?  I've been evaluating using the two products together and have been very disappointed, especially after years of great JIRA usage.

    Here are the points that are listed under the 'integration' documentation:

    • Use Trackback for easy two-way linking - does not work according to documenation.
    • View Confluence content in JIRA or JIRA content in Confluence - jiraportlet macro does not work with most recent versions.  jiraissues macro only works sometimes: we have trust issues, need to enable anonymous access?, some users see the list of issues, some don't, list does not update in a timely fashion, cannot be used to show a single issue, absurdly difficult to set up.  For a key feature for 'integrated' products, this is half baked at best.
    • Link to Confluence pages from JIRA issues - have to install a plugin.  Does not work with hosted versions that I am evaluating. 
    • Integrate JIRA and Confluence user-management - does not work with hosted versions.  Installed versions require an external database or another Atlassian product..

    The two products can be used together in the sense that you can enter links in one that lead to the other.  That's it.

    I love JIRA and it makes my life much easier.  I think Confluence is a nice wiki.  But the do not integrate. I apologize if this is not the place to post non-constructive criticism. However, I would have appreciated a clearer view of the 'integration' features a week ago.

    1. Sep 08, 2010

      Anonymous

      I spent many days trying all types of integration. I am using trial hosted versions of Jira and Confluence. I could not get a simple list of Jira issues to display on a Confluence page. Nothing seemed to work. The documentation is very sporadic and inconsistent. I am getting disappointed. I guess I will submit another support ticket for that.

  14. Mar 10, 2010

    Anonymous

    Hi,

     Does anybody here know of successful integration between Shibbolized Confluence and JIRA?

    Cheers

    1. Mar 15, 2010

      Jack Low [Atlassian]

      Hi,
      The shibboleth Authenticator can be integrated directly with JIRA, but Atlassian do not support it, nor have we written any connectors for it.

      Personally I've limited knowledge about it, sorry to say that we can't be of further help.

      Hopefully someone who has done it before can share with you here.

      Thanks & regards,
      Jack

  15. Apr 01, 2010

    Anonymous

    Hello,

    Is there a way we can display the admin page from jira (list of all the project and their administrator in jira) in confluence page?

    We've a requirement where few users need to see the Admin of all the jira project without giving them the actual admin rights on jira.

    CAn you please suggest if there is a way to do that?

    Himanshu

    1. Apr 02, 2010

      Jack Low [Atlassian]

      Hi Himanshu,

      Is there a way we can display the admin page from jira (list of all the project and their administrator in jira) in confluence page?

      Do you mean "list all the project and their Project Lead"? If so, this is possible by using the HTML Include Macro to display the Browse Project page from JIRA. For example:

      {html-include:url=http://<yourJIRAHost>:<yourJIRAPort>/secure/BrowseProject.jspa?os_username=<yourUsername>&os_password=<yourPasssword>}

      Please replace these values - <yourJIRAHost>, <yourJIRAPort>, <yourUsername>, and <yourPasssword> accordinglly.

      Please note the user can only see those project(s) that (s)he is granted with "Browse Project" permission.

      If you would like to list all JIRA administrator(s), you can use:

      {html-include:url=http://<yourJIRAHost>:<yourJIRAPort>/secure/Administrators.jspa}

      Please ensure the HTML macros is enabled before trying the suggestions above.

      Hope it helps. Please give it a try and feel free to ask a again if you need further assistance.

      Thanks & regards,
      Jack

  16. Dec 10, 2010

    Anonymous

    Is there a way of having a link in confluence to export Jira issues in excel?

    thanks,

    Ines

  17. Jan 11, 2011

    Anonymous

    Is there any way to display an entire JIRA dashboard in Confluence?

  18. Jan 24, 2011

    Abrham Smith

    When I use the context [TEST-1@JIRA] I get a mailto: instead of the shortcut I am suppose to get.  Is there anyway around this? I am using internet explorer 8.

  19. Apr 11, 2011

    Anonymous

    This info is outdated.

  20. Apr 25, 2011

    Michael Bevilacqua

    Is it possible for the Jira link to display the issue Summary text in Confluence automatically?

    Instead of CONF-1000, display CONF-1000 Get Confluence working on Resin 3.x

    1. May 04, 2011

      Anonymous

      Seconded. This would be great!

    2. May 04, 2011

      Mark Hrynczak [Atlassian]

      The summary text will be displayed automatically, along with the issue type and status, if you enter the link using the 'Insert JIRA Issues' dialog introduced in 3.5.

      For more information, see the release notes

      Cheers,
      Mark

  21. Sep 30, 2011

    Arielle Hoffman

    How do you set up search for Confluence via the JIRA dashboard? (Atlassian does this on support.atlassian.com in the Information gadget.)

    1. Oct 16, 2011

      Edwin Dawson [Atlassian Technical Writer]

      Hi there Arielle Hoffman,

      Support.atlassian.com uses a very specific customisation, involving inserting custom HTML into the Confluence Admin screens (Confluence Admin > General Configuration > Edit). The custom HTML is inserted into the "Site Welcome Message" section.

      If you would like more details, drop me an email at edawson at atlassian dot com.

      1. Dec 12, 2011

        Sam Kenny

        Is it possible to do the reverse?  i.e. Search my JIRA instance from Confluence?

        Thanks.

  22. Oct 04, 2011

    Anonymous

    So do I have to install a plug-in (JIRA Linker) if I want to reference Confluence pages within a JIRA issue?  That seems a pretty standard operation so surprised it requires a plug-in.  

    1. Oct 04, 2011

      Paul Watson [Atlassian Technical Writer]

      Thanks for your comment!

      JIRA Linker provides a way to search for pages on a Confluence site, so you can easily add a page link to a JIRA issue. Of course, you can always just add the link manually...

  23. Dec 07, 2011

    Fujitsu Karlskrona

    Probably a really stupid question, but...

    I've installed the Jira Linker Plugin and set up trusted communication between Jira and Confluence.

    When I click the Search Confluence link next to the Confluence Link custom field, the confluence site to search is http://confluence.atlassian.com

    How do I change it to search my confluence site??

    1. Jan 20, 2012

      Russ Collier

      See https://studio.plugins.atlassian.com/wiki/display/JLINK/Home#Home-ConfiguringcustomConfluenceservers

  24. Jan 27, 2012

    Markus Baumgartner

    Some new users not familiar to JIRA abort the process of opening an issue because of the new environment, they don't know  the meaning of the fields etc.

    Is it possible to provide a form in confluence, that will open a JIRA issue directly in a transparent, means in a hidden way directly in the post request so the user is not redirected to the JIRA form?