Linking Jira with Confluence using Gaia for Jira app

Gaia for Jira app allows you to create a new Confluence space once you create a new Jira Project. On this page, we would like to share some features that you can use to quickly and easily connect Jira and Confluence.

Pre-requisites

This tutorial was written considering that :

• you have a Jira instance installed and running on your server with Gaia for Jira installed;
• you have a Confluence instance installed and running on your server or you are using the Confluence Cloud service from Atlassian;
• you are logged into Jira and Confluence.

Linking Jira issues with Confluence pages

This section contains the instructions to automatically create Jira issues links into the Confluence pages of your templates, by adding the Gaia tags for Jira issues.

1. Adding the Jira Issues Gaia tags into a Confluence page :

In your Confluence Space template, create a link to a Jira issue, by adding the following tag element into your text

##ID:mytag##

Where mytag represents a unique string. The figure below depicts an example of using tags in a table element. Here, mytag is replaced with 1.1 and 1.2. Tags can be added anywhere in the text section of a Confluence page. 

2. Add the same tag in the Jira issue you want to link :

To associate a tag added into a Confluence page to any Jira issue, add the exact same tag in the Comments section of a Jira issue, as shown below :

3. Create the template files:

To use this feature, you need to export your templates by creating the Jira issues file and the Confluence Space file.  When the files are created, use them in your templates settings in the Gaia Configuration. 

You're done!

Linking Jira project with Confluence JQL queries

This section contains the instructions to automatically update the JQL queries used in Confluence macros, by adding Gaia tags.

Adding the Jira project key Gaia tag into a Confluence JQL query:

In your Confluence Space template, when you specify a JQL query in a macro (e.g: Jira Issue) you can use the tag ##PROJECTKEY## to add a reference to the project that will be created from that template.

When the project will be created, Gaia for Jira will automatically replace this tag by the project key.

For example:

Automating the insertion of the project title and project key in Confluence pages

This section contains the instructions to automatically insert the name of the space and the project key into Confluence pages or Confluence macros, by adding Gaia tags.

Inserting the project name or project key in a Confluence page

In a Confluence page content or page titles of your template, you may, at any time, add a tag to insert the project name or the project key after project instantiation. This allows generating more dynamic Spaces, which refer to the current project instance. Just add the following tags:

Inserting the project name or project key in a Confluence macro

Besides, you may also insert these tags in Confluence macros. For instance, the Roadmap Planner macro may refer to the tags described above.