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. |
|
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 CommentsApr 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.
Jun 28, 2005
Anonymous
I'd like to see trackback working for protected pages as well. Please update us!
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.
Aug 15, 2005
Tom Davies
There's no way of doing this at the moment.
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.
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.
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?
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
Mar 15, 2006
Matt Ryall (Atlassian)
There are two outstanding feature requests that cover this functionality: CONF-2689, CONF-1436.
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
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
Jan 25, 2007
Mei Yan Chan
A clearer parameter (the above is 'macroed')
[PRJNAME open Tasks@jira]
Regards,
Mei
Jan 29, 2007
chenmin
It really works~!
Thank you very much~
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.
Aug 28, 2007
Kari Sutela
Found it! Underscore appears to work: [PRJNAME web_integration@jira]
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.
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.
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.
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:
It would be cool to have a list of external wikis (confluence1, confluence2) in the admin section so that something like this would work.
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
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!
Dec 11, 2007
Sarah Maddox [Atlassian Technical Writer]
Hi Joshua
With Confluence 2.7 and JIRA 3.12, this should be good to go
Cheers – Sarah
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
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
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.
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.
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:
How can I get this functionality in Confluence 3.1? Can I run 3.2-rc1?
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:
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.
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.
Mar 10, 2010
Anonymous
Hi,
Does anybody here know of successful integration between Shibbolized Confluence and JIRA?
Cheers
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
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
Apr 02, 2010
Jack Low [Atlassian]
Hi Himanshu,
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
Dec 10, 2010
Anonymous
Is there a way of having a link in confluence to export Jira issues in excel?
thanks,
Ines
Jan 11, 2011
Anonymous
Is there any way to display an entire JIRA dashboard in Confluence?
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.
Apr 11, 2011
Anonymous
This info is outdated.
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
May 04, 2011
Anonymous
Seconded. This would be great!
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
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.)
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.
Dec 12, 2011
Sam Kenny
Is it possible to do the reverse? i.e. Search my JIRA instance from Confluence?
Thanks.
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.
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...
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??
Jan 20, 2012
Russ Collier
See https://studio.plugins.atlassian.com/wiki/display/JLINK/Home#Home-ConfiguringcustomConfluenceservers
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?
Add Comment