Use JIRA and Confluence together

1. In the editor choose Insert > JIRA Issue
2. Follow the prompts in the macro browser to choose a project and search for an issue – you can even use JIRA Query Language (JQL).

Once you've added the macro, you can customise how the issue or list of issues appears on the page, including how much information to display, how many issues, and more.

Create JIRA Issues from Confluence

You can create issues while viewing Confluence a page, or from the within the editor. This is really useful if you use Confluence for requirements gathering. 

To create an issue when viewing a page:

1. Highlight some text on your page and choose the Create JIRA issue icon  that appears above the highlight
2. Enter or select the following information:
   • Server (if you have multiple instances of JIRA connected to Confluence)
   • Project
   • Issue Type
   • Summary (your highlighted text will populate the issue summary by default)
   • Description (optional)
3. Choose Create

The issue will be created in JIRA and added to your page. If your text is in a table, you'll have the option to create multiple issues using text from the same column.

If you don't see a popup when you highlight text, check that Text Select is enabled in your profile settings.

To create an issue in the editor:

1. In the editor choose Insert > JIRA Issue > Create new issue
2. Enter or select the following information:
   • Server (if you have multiple instances of JIRA connected to Confluence)
   • Project
   • Issue Type
   • Summary (your highlighted text will populate the issue summary by default)
   • Description (optional)
3. Choose Insert

The issue will be created in JIRA and added to your page.

There are some limitations when creating JIRA Issues from Confluence. The JIRA Issues macro or Create JIRA Issue dialog will notify you if it's unable to create an issue in the selected project. You can find out more in the JIRA Issues Macro page. 

Creating reports and charts

Reporting on information stored in JIRA is simple in Confluence. In addition to the JIRA Issues Macro, you can use the JIRA Report blueprint or JIRA Chart macro. 

You can:

• Use the JIRA Report blueprint to create a Change Log or Status report.
• Use the JIRA Issues Macro to display a list of resolved issues, for example for use in release notes.
• Use the JIRA Chart Macro to display data as a pie chart. 

Promp users to add JIRA Issues to a page

If you use templates (including templates provided by blueprints), you can add a JIRA Issue placeholder that, when clicked, opens the JIRA Issues macro and prompts users to search for or create a JIRA issue.

For example, the JIRA Issues placeholder is used in the Product Requirements blueprint. See Create a Template for more information on using instructional text and placeholders.

View connections between Confluence and JIRA

The JIRA Links button gives you quick access to issues connected to the Confluence page you're viewing.  

Links are displayed when:

• You've created or added single issues to the page using the JIRA Issues macro in Confluence.
• You have added a link from the issue to the Confluence page in JIRA.

If you use JIRA Agile, sprints and epics will also appear on the JIRA Links button. 

The number on the JIRA Links button indicates the total number of issues connected to the page, regardless of whether you have permissions to view the issues. The dropdown will only show issues, epics and sprints that you have permission to view in JIRA. 

Note:

• The JIRA Links button only appears in the default theme; it's not available in the Documentation theme.
• The JIRA Links button doesn't detect links from issues displayed in the JIRA Issues macro in table format.