In this Atlassian Confluence tutorial, learn how to manage projects and programs using project management dashboards, roadmaps, action lists and issue and ri. We offer services in the areas of project and construction management, safety compliance, independent verification and specialist programming and planning.
Jira and Confluence are powerful tools for keeping teams organized. Jira is a project management platform used by over 65,000 companies that can help with everything from software development to managing your wine collection, and Confluence is a wiki-based content management tool that makes organizing written information easy.
You can use Jira and Confluence separately to improve project management, and both tools are valuable on their own. However, integrating Jira and Confluence allows organizations to take advantage of the tools’ complementary roles and improve communication, access to information, and overall efficiency.
Keep reading to learn more about the benefits of integrating Jira and Confluence, how to connect them, and some of the best ways to use them in tandem.
Why use Jira and Confluence Together?
Organizations can take project management to another level by integrating Jira and Confluence.
Get the Information You Need, When You Need It
When you're working on a complex project, it can be difficult to provide the right amount of information on a given topic. You need to ensure critical information is readily available to those who need it, but avoid overwhelming team members with a deluge of information that might prevent them from finding what they need.
Using Jira and Confluence together helps square this circle. You can incorporate Confluence documents into Jira issues, or vice versa, to provide more information for those who may need it without distracting those who don’t. You can even search through text fields in Jira issues linked to Confluence. With everything organized in one place, your team will never spend time chasing down information again, or wondering how that information relates to a project.
Your Team Will Always Know What to Do Next
Ensuring that all members of your team stay aligned and on track is one of the most important aspects of project management. Combining Jira’s issue-tracking functions with Confluence’s content management capabilities makes this easy. For example, you can review overall progress on a project and find what work remains outstanding in Jira, then seamlessly move to a linked Confluence page to review any relevant inline comments and collaboratively edit it with other team members.
Improve Your Team’s Efficiency
Using Confluence and Jira together helps your team make the most of its time. Instead of having to open and search through each tool separately to find relevant information, you can find what you need in one tool and instantly see related information that is linked from the other tool. This means your team spends less time switching between tools or trying to figure out where information is and more time using that information productively.
How to Integrate Jira and Confluence
Using Confluence For Project Management
Once you have Jira and Confluence installed, either in the cloud or on your own infrastructure, integrating them is a simple process. It starts with opening the General Configuration tab in the settings menu of Jira or Confluence:
You should then open Application Links, where you can add the URL of the Jira or Confluence instance that you want to connect:
After you've added the URL for the instance you want to integrate, the application will prompt you to create a reciprocal link. In other words, if you added the URL for your Jira instance to Confluence, open Jira and add the Confluence URL. You will only be able to link Jira and Confluence bidirectionally if you are an admin on both instances. You can copy a secret key for another administrator to make the reciprocal link if needed.
You can also choose what type of connection you want to use. OAuth authentication is the best choice most of the time, although certain applications may rarely require OAuth (impersonation).
You should verify that the instances you want to integrate can communicate over your network. If, for example, one instance runs behind a firewall and is inaccessible to the other instance, you'll need to create firewall rules to let the instances talk to each other for the integration to work.
After you’ve integrated Jira and Confluence, you can also efficiently move between linked Jira issues and Confluence pages by selecting the Jira Links button at the top of the Confluence page:
Jira and Confluence support a wide range of external integrations as well. They can integrate with Jenkins and GitHub to help manage source code, email systems such as Gmail and Microsoft Outlook, and many other types of tools. You can learn more by reviewing Atlassian's Jira integrations and Confluence integrations guides.
Using Jira with Confluence
After you've integrated your Jira and Confluence instances, you can begin to use them together to save time and improve project management.
Creating and Displaying Jira Issues in Confluence
If you're working in Confluence, you can create a Jira issue and add it to your project directly from Confluence. This way, if you discover an issue that you’d like to track in Jira as you are reviewing documentation in Confluence, you don’t have to open Jira to do so.
There are two primary ways to do this. First, you can simply highlight text in Confluence. After a moment, a box will pop up with an option to create a Jira issue, as indicated below:
Alternatively, you can open the macro browser in Confluence and add a Jira macro:
You can change how the issue is displayed by selecting the macro when editing the Confluence page, then selecting “Display options” at the bottom of the Search tab:
Issues can be displayed either as a single issue, which only shows the issue key and status, or as a table, which provides more information.
Creating Jira Charts in Confluence
You can also create a Jira chart within Confluence to provide valuable information and context. To do so, select “Jira Issue/Filter” from the Confluence macro browser again and then click on Jira Charts. From there, you'll be able to select which type of chart to create:
You can use Jira filters or the Jira Query Language (JQL) to pull in the issues that you want to display on the chart.
Working with Sprints
You can work with Jira Software sprints from within Confluence. Sprints help manage particular efforts within a Jira Software project, such as the release of a new version of an application. You may wish to trigger sprints as you’re working with Confluence documents.
There are several ways to create sprints in Confluence. For instance, you can link a Jira sprint to Confluence by clicking on “View linked pages” in the sprint, as shown below:
You can then link the sprint to an existing Confluence page, or even create a new page that will be automatically linked to the sprint.
You can also use JQL to include a sprint within a Confluence page:
Add Jira Gadgets to Confluence
You can use any Jira gadget in Confluence as well. Gadgets display data that helps you track the progress of a Jira project. Making this data visible when working with Confluence pages keeps team members informed without making them switch between tools.
To add a gadget to Confluence, open Jira, create the gadget you want to display, click the 'Display XML' link, and copy the URL:
Then, in Confluence, go to the administration section and search for external gadgets. You'll see a result like this:
Click it to open a dialog where you can paste in the XML link of the gadget you want to add:
The gadget will then be usable in Confluence, and its name will be the same as it was in Jira:
Create Release Notes in Confluence
When the time comes to issue a software release for a project you are managing with Jira, you can create release notes for it right in Confluence, which provides a template to make the process easy. You can find it by clicking on “Create from template” in the menu in the top-left corner of the Confluence page:
Using Jira For Project Management
From there, choose to “Jira report,” then select “Change log report” to open the template. Fill in the information you want to record about your release, and you're all set.
If you want your release notes to be publicly available, rather than for internal use only, you can create a release notes base page in Confluence, then turn it into a template that you can use each time you issue a new release.
Confluence and Jira Service Management
Linking Jira Service Management projects to a knowledge base space in Confluence can make it easier for support personnel to find the information they need within your Confluence documentation database when they are responding to a support request.
To set up the link, open your service desktop project in Jira, navigate to “Project settings,” then select “Knowledge base.” Choose the “Link to a Confluence space” option and select the knowledge base space you want to connect to.
By making this connection, pages that you create in the knowledge base space will be searchable from your support portal, as illustrated below:
Make Integration Easy
Getting the most value from integrating Jira and Confluence requires a deep knowledge of both tools and the broader Atlassian ecosystem. Your approach to using Jira and Confluence together should be tailored to meet your enterprise’s unique needs.
The Atlassian experts at Contegix can help by sharing key guidance for configuring Jira and Confluence, as well as identifying how to use them together to best achieve business goals. Contact Contegix to learn more.
When you’re managing a project, you have to kill it in the coordination game – it’s all about sweating the specifics and ensuring your team is equipped with the right resources. Confluence can help you manage the details for all of your projects and keep your team well-informed. From software development to big marketing campaigns, or even company events, project management in Confluence helps you get any project off the ground, stay in touch with the rest of your team, and make sure everyone is moving in the same direction.
3 ways Confluence helps project management chaos
In this day and age, it takes a village to ensure a successful project outcome. Here are three tangible ways you can use Confluence for project management to take some of the weight off:
1. Create, share, and update project plans in one place
Creating a single project planning page that tracks all the work for your project – including the people involved and project deadlines – gives you the transparency you need to make your teammates self-sufficient. No more uncertainty, incessant clarification emails, or taps on the shoulder. A planning page becomes a project’s single source of truth for the rest of the business, allowing the project team to stay heads-down and focused on what needs to get done.
At Atlassian, we create project planning pages on our internal instance of Confluence for any and all types of projects. Key stakeholders for the campaign can access this page anytime and anywhere, make contributions, and offer feedback or ask questions using comments. Rather than having one project manager rally everyone across the finish line, we’re able to work cooperatively and synchronously to accomplish milestones and achieve our end goal – working effectively as a team.
Not sure where to start when creating a project planning page? We’ve outlined a few steps for you, and a few templates to get you started:
- Create a new blank page in your team’s Space.
- Title the page with your project name. Below, add the necessary information on the project that any visitor would need to understand the basics. Some ideas are a high-level overview, the team involved, major Jira tickets, resources on background information, action items or major deliverables, and visuals. Pro tip: use macros like Gliffy for diagrams or the Jira issues macro to insert tickets.
- Share the page (upper right-hand corner) with relevant stakeholders and the rest of your team.
Atlassian Project Management
Confluence has given us a centralized place for all teams and departments to document, track, and collaborate within and across Nextiva.Josh Costella, Sr Solutions Specialist at Nextiva
2. Assign tasks to keep your team on track
A key element of our project planning page is using Confluence Tasks. Tasks help you focus on the most important deliverables and eliminate the extra work that’s just a distraction.
@ mention team members to assign tasks for all of the main project deliverables straight from the project planning page. This lets everyone involved know what they need to get done, by when, and where they can report on the status of their deliverables. Creating tasks from the project planning page makes them contextual, cutting down on the back-and-forth noise, status meetings, and uncertainty that are all too common for team projects.
Confluence Project Tracking
3. Make decisions online
Throughout the life of an Atlassian team project, we send approximately zero emails. One project held just five meetings. FIVE! The project planning page keeps everyone informed on how the project is progressing and any updates being made, removing the need for status meetings. If someone has a question or decisions need to be made, they comment at the bottom of the page or inline with the text where we can keep the conversation where it’s relevant and with added context, rather than siloing it in our email inboxes or calling an unnecessary meeting.
When we have a meeting, we ensure it’s focused and purposeful by creating an agenda in Confluence. Having all of our project documentation in one place, being able to link to other pages, and extensive use of tasks gives added context, making our meetings with other stakeholders as short as 15 minutes, in which we answer just three questions:
- What did you complete last week?
- What are you working on this week?
- Are there any blockers?
Using Confluence means:
- You and your team have a single source of truth, which saves time by harnessing your teams’ collective knowledge into easy-to-find answers for everyone.
- Work can move forward. From actionable meeting notes to inspiring project plans, kickstart team participation with a flexible workspace.
- You can work together and encourage all teams – from marketing to engineering – to share announcements, strengthen company culture, and get instant feedback.
Most importantly, Confluence lets project managers focus on coordination, execution, and ensuring they reach the finish line in one piece.
New to Confluence? Try it for free and see how Confluence can help reduce your team’s reliance on email. It’s time to make work about work again.
Want to discover how Atlassian products have shifted the way other companies work? Join the Confluence project management conversation on the Atlassian Community.