Confluence Jira Integration
Confluence and Jira are both Atlassian products, and they connect natively without any third-party plugins. Linking them lets your team write documentation in Confluence and track the related work in Jira — and both tools stay in sync automatically.
Why Connect Confluence and Jira
Documentation and tasks live in separate worlds without integration. An engineer reads a feature spec in Confluence but has to switch to Jira to find the related tickets. A project manager writes meeting notes in Confluence but must manually copy action items into Jira. Integration removes that friction.
Before vs After Integration
WITHOUT INTEGRATION WITH INTEGRATION
────────────────────────────────────── ──────────────────────────────────────
Confluence: spec doc Confluence: spec doc
Jira: ticket ENG-42 ↕ live link ↕
Jira: ticket ENG-42
You check each tool separately. See Jira status inside Confluence page.
Copy-paste updates between tools. Changes in Jira reflect in Confluence.
Risk of information going out of sync. One source of truth across both tools.
Linking Your Confluence Site to Jira
If both tools use the same Atlassian account, they link automatically. Go to Confluence Settings → Application Links to verify the connection or add a new Jira instance.
Connection Check Steps
STEP 1 → Go to Confluence Settings (⚙ top-right, site-wide)
STEP 2 → Click "Application Links"
STEP 3 → Look for your Jira instance in the list
STEP 4a → If listed: connection exists — you are ready
STEP 4b → If not listed: click "Create link" and enter your
Jira URL to connect
Embedding Jira Issues in a Confluence Page
The Jira Issues macro pulls live ticket data directly into any Confluence page. The data updates automatically — you never update it manually.
Inserting the Jira Issues Macro
STEP 1 → Open a Confluence page in edit mode STEP 2 → Type /jira in the editor STEP 3 → Click "Jira Issues" from the dropdown STEP 4 → Choose your insert method: METHOD A — Paste a Jira URL: Paste the URL of a single Jira issue directly. → Shows one issue inline on the page. METHOD B — Use a JQL query: Type a Jira Query Language filter, e.g.: project = ENG AND sprint in openSprints() → Shows a live table of all matching issues. METHOD C — Paste multiple issue keys: Type issue keys separated by commas, e.g.: ENG-42, ENG-43 → Shows those specific issues as a table.
Jira Issues Macro Output Example
JIRA ISSUES — Open bugs in ENG project ────────────────────────────────────────────────────────────────── KEY SUMMARY STATUS ASSIGNEE ────────────────────────────────────────────────────────────────── ENG-142 Login timeout on mobile In Review Priya Sharma ENG-143 API rate limit error In Progress Raj Mehta ENG-145 Docs page 404 on load To Do Unassigned ────────────────────────────────────────────────────────────────── 🔄 Updates live — reflects current Jira status at all times
Linking a Confluence Page to a Jira Issue
You can link any Confluence page directly to a Jira issue. This creates a two-way connection — you can open the linked Confluence page from inside Jira, and open the Jira issue from the Confluence page.
Adding a Page Link in Jira
STEP 1 → Open the Jira issue
STEP 2 → Click "Link" in the issue details panel
STEP 3 → Select "Confluence Page"
STEP 4 → Search for the Confluence page by name
STEP 5 → Click Save
RESULT → Jira issue shows a link to the Confluence page
Confluence page shows a link back to the Jira issue
Creating a Jira Issue from Confluence
You can create a new Jira issue without leaving Confluence. Highlight any text on a Confluence page, click the Jira icon that appears, and Confluence creates a Jira issue pre-populated with that text as the issue summary.
Create Jira Issue from Confluence Text
CONFLUENCE PAGE TEXT:
"The login button colour does not meet accessibility standards."
STEP 1 → Highlight the sentence above
STEP 2 → Click the Jira icon (🔵) in the tooltip bar
STEP 3 → Choose project: ENG
STEP 4 → Choose issue type: Bug
STEP 5 → Click Create
RESULT:
Jira creates: ENG-146 "The login button colour does not meet
accessibility standards."
Confluence inserts: a Jira status badge next to the text
Confluence Project Pages and Jira Boards
Teams often create a Confluence project space alongside their Jira project. The Confluence space holds the documentation — specs, decisions, meeting notes — while Jira tracks the tasks. Link the two using a Jira Issues macro on the Confluence space homepage so the page shows live sprint progress.
Recommended Structure
CONFLUENCE: Engineering Space ├── 📄 Space Home [Jira Issues macro: current sprint] ├── 📄 Architecture Overview ├── 📄 Feature Specs │ ├── 📄 Auth Module Spec [links to ENG-100 to ENG-115] │ └── 📄 Payment Spec [links to ENG-116 to ENG-130] └── 📄 Release Notes JIRA: ENG Project └── Issues ENG-100 to ENG-130 all link back to Confluence specs
JQL Basics for the Jira Issues Macro
JQL (Jira Query Language) is a simple filter language. You write a condition and Jira returns the matching issues. You do not need to know programming — JQL reads like plain English.
Common JQL Examples
WHAT YOU WANT JQL
──────────────────────────────────────────────────────────────────────────
All open issues in ENG project = ENG AND status != Done
My assigned issues assignee = currentUser()
Issues due this week due <= endOfWeek()
All bugs in current sprint project = ENG AND type = Bug
AND sprint in openSprints()
High priority unassigned issues priority = High AND assignee is EMPTY
Paste any JQL query into the Jira Issues macro to embed a precisely filtered live list of tickets on your Confluence page.