Integrating Confluence and JIRA

Northland, New ZealandSince our team is moving to JIRA for tracking bugs and enhancements, and we’re creating a new customer portal, possibly using Confluence, I’ve been thinking about ways to make our process for release notes smoother and more efficient.

Currently, we write up Word documents for each issue, and then compile the documents into a single document once we know which features are being added to the release. It’s a process that’s cumbersome and prone to error.

Instead, I’d like the team to document the issues in JIRA. Then we can pull the documentation from JIRA into a Confluence page, and use a report to find which corrections and enhancements have been included in the release.

That means getting the two applications to work together. I’ve upgraded Confluence to version 3.5, so I think this will be easy, but let’s see.

First I need to link the two applications together.

[Confluence 3.5, JIRA 4.3]

1. Add an application link in JIRA

  1. In JIRA, from the Dashboard, click Administration.
  2. Select JIRA Administration.
  3. Click Application Links.
  4. Click Add Application Link.
  5. Follow the instructions in the wizard.

2. Link a JIRA project to a Confluence space

  1. In JIRA, from the Dashboard, click Administration.
  2. Select the project.
  3. Click Configure Application Links.
  4. Click Add Link.
  5. Select Confluence.
  6. Select the space.

I’ve already created an issue in JIRA, so now I want to pull that issue into my Confluence page.

3. Display a JIRA issue on a Confluence page

  1. In Confluence, find the page where you want to add the JIRA issue.
  2. Click Edit.
  3. Click the Insert JIRA Issue icon.
  4. Select the issue.
  5. Click Insert.

Easy! But not exactly what I want.

What I want is a list of all the enhancements and corrections for a particular release. And I want our clients to see only the documentation about what’s new or updated, not the full history of each issue.

More to come next week…

Update: See part 2.

If you liked this post, consider subscribing to my RSS feed. Or have posts delivered via email. Thanks for visiting!

Photo via Flickr user Heike Quosdorf

3 thoughts on “Integrating Confluence and JIRA

  1. What about the OTHER direction, linking from JIRA to Confluence? I can not for the life of me figure this out. I’d really like to be able to link a JIRA issue to a page specific to the issue that allows relations to news posts, comment threads, etc. I understand that JIRA has that as well, but it’s nice to relate, e.g., a story on UI design to the UI design specifications that we have on Confluence. But other than doing a direct link without automatic page discovery, I can’t get it to work!

  2. Hi Jenny,

    I wanted to see my confluence content in JIRA. how that is possible?

    Please update the page

    Thank you

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.