Integrating with Confluence

What is Confluence?

Confluence is a content creation and collaboration platform that connects teams with the content, knowledge, and coworkers they need to get work done, faster. Confluence spaces are great for creating and organizing rich content related to Jira projects using Confluence pages – meeting notes, project plans, requirements documents, release notes, roadmaps, and more.

Give your team the ability to share, discuss and work with Jira application issues in Confluence, and create knowledge articles for your service project customers. Here are some of the ways you can benefit from integrating Confluence with your Jira applications:

For...

You can...

BugsCreate a knowledge base article to document a workaround for a bug.
New Features

Create a product requirements document for a new feature.

Self-serviceCreate knowledge articles that customers can view on the customer portal to find solutions themselves
General Jira Use Case

Document and collaborate with your team on an issue in Confluence.

And here are just a few of the things Confluence allows you to do:

  • Share pages 
  • Watch pages
  • Create knowledge articles from service project issues
  • Collaborative commenting, especially through the use of @mentions
  • Form a team network and let them know what you are doing via a status update
  • Add images, picture galleries, videos, and more
  • Enable various content macros

Ready to add Confluence to Jira? Go to Pages in Jira's sidebar, and begin your free trial. You can cancel at any time via Manage Applications.

See Integrating Jira and Confluence  for more information. 

Confluence features for Jira users

Here are some of the best features of Confluence that Jira users would benefit from.

Define product requirements

Many of our customers write product requirements documents using Confluence to plan new product features. The Product Requirements Blueprint helps development teams collaboratively create, discuss, and organize their product requirements. It's easy to link your product requirements in Confluence to issues in Jira.

For more information, see Blueprints.


  • Define the properties of the document, which are then indicated on any page with the Page Properties Report macro.
  • Communicate the status of your product requirements with the status macro.
  • Use @mentions to automatically notify key stakeholders.


Team Calendars for Confluence: Your Birds-Eye View of Jira

Surface everything your development team is working on in Jira to the teams that live in Confluence with Team Calendars.

  • Timeline Calendar: View plans 3 months ahead of time
  • JQL Support: Track your versions, issues, and agile sprints
  • Date Ranges: Visualize issues over time to understand upcoming workload

To install this feature, please visit Atlassian Marketplace.

Insert issues on any Confluence page using the Jira issues macro

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. With the Jira issues macro, you can:

  • Display a table of issues on your page, based on the results of a search using JQL or a Jira URL.
  • Display a single issue from the Jira site, or a subset of selected issues from your Jira search results.
  • Display a count of issues from the Jira site.
  • Create a new issue on the Jira site and display that issue on your page.

Auto-convert makes producing reports of issues, backlogs, and tasks as easy as copy and paste. With Jira and Confluence connected, you can paste individual issues or Jira query URLs into the editor and watch them immediately transform into the Jira issues macro.

Whenever an issue is mentioned in a Confluence page using the Jira Issues macro, Jira will create an issue link to that page for you, automatically. Specs to issues, knowledge base articles to support tickets, project outlines to tasks – it all works.

Last modified on Nov 17, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.