/
Jira Macro Integration

Jira Macro Integration

Integration with Jira Macros

Using our products: External Share for Confluence and External Share for Jira it is possible to share Jira issues, filters and boards embedded on your confluence pages on our shared pages.

Jira Macros allow you to display dynamic Jira content directly on your Confluence pages. This helps teams stay aligned by keeping relevant Jira data visible and updated within the context of your documentation or project pages.

Learn more about macros: Display Jira work items in a list | Confluence Cloud | Atlassian Support

How it Works

To use Jira Macros on shared Confluence pages, External Share for Jira and External Share for Confluence must be installed. This is because macro fetches Jira data (e.g., issues, filters) by sending a request via External Share for Jira app, which communicates with the Jira REST API. Later, app returns the data in HTML format, which is then embedded into the shared Confluence page.

Available Jira Macros on Shared Pages

Below is a list of available macros and how they appear on shared pages.

Important
Jira data is displayed based on the access rights of the last user who modified the Confluence page. If that user doesn't have access to certain Jira issues or filters, those items will not appear on the shared page.

Issue (Work Item) Related Macros

Macro Name

Macro Setup Options

Result on Shared Page

Macro Name

Macro Setup Options

Result on Shared Page

/Create Jira work item

image-20250707-155921.png

 

 

 

image-20250522-135740.png

/Jira work items

image-20250707-161725.png
image-20250522-140204.png

 

image-20250707-150306.png

/Issue in progress

image-20250707-160037.png

Display options

  • Number of results (max. 50)

  • Fields to display

  • Refresh interval

image-20250707-155257.png

 

/Assigned to Me

image-20250522-135636.png

/Voted Issues

Display options

  • Number of results (max. 50)

  • Fields to display

    • Show the total votes per issue

    • Include resolved issues

  • Refresh interval

image-20250925-125746.png

 

/Watched Issues

Display options

  • Number of results (max. 50)

  • Fields to display

    • Include resolved issues

  • Refresh interval

image-20250925-131252.png

 

URL (Issue, Board, Timeline)

How to insert it?

image-20250707-135704.png

Simply paste the Jira contents URL into your Confluence page. Then, share the page externally.

Macro

Result on Shared Page

Macro

Result on Shared Page

 

 

 

 

 

 

Issue URL

 

 

 

 

 

How to:

Navigate to Jira Project → Select Work Item (Issue) → copy URL

URL View

image-20250522-134926.png

Inline View

image-20250522-134958.png

Card View

image-20250709-144649.png

Embed View

image-20250707-140423.png

 

 

 

 

Issue Table URL

 

 

 

 

How to:

Navigate to Jira Project → Select All Work → copy URL

URL View

image-20250707-141335.png

List View

image-20250522-140346.png

Board URL

 

 

 

How to:

Navigate to Jira Project → Select Board → copy URL

Embed View

image-20250707-145103.png

Timeline URL

How to:

Navigate to Jira Project → Select Timeline → copy URL

Embed View

image-20250707-145636.png

List View URL

 

How to:

Navigate to Jira Project → Select List → copy URL

Embed View

image-20250707-145958.png

Jira Legacy Macros

Using the Jira Legacy macro, you can:

  • Display a list of work items on your page, based on a Jira Query Language (JQL) search, filter or URL.

  • Display a single work item.

  • Display a count of work items.

  • Create new work items and display the work items on your page without leaving Confluence.

Macro

Result on Shared Page

Macro

Result on Shared Page

 

 

 

/Jira Legacy

Single Issue View

image-20250522-141112.png

 

Table View

image-20250522-141159.png

Total Issue Count View

image-20250707-150306.png

Jira Charts Macros

Search using any issue key, search URL, Jira link, JQL, plain text or filter, e.g. filter = "My JIRA filter"

Macro Name

Macro Set up option

Result on Shared Page

Macro Name

Macro Set up option

Result on Shared Page

/Pie Chart

image-20250707-164448.png

Display options

  • Chart by (category, assignee, etc.)

  • Width

  • Show border

  • Show chart info

image-20250522-142237.png

 

/Two Dimensional Chart

image-20250707-164521.png

Display options

  • Set up X and Y axes

  • Select rows to display

image-20250522-142255.png

/Created vs Resolved Chart

image-20250707-165437.png

period

Days previously

Show versions

width

image-20250707-165453.png

 

Other Macros

Macro Name

Macro Set up option

Result on Shared Page

Macro Name

Macro Set up option

Result on Shared Page

 

/Filter Results

image-20250707-163456.png

You should choose filter name

image-20250522-141424.png

 

 

 

/Agile Wallboard Gadget

image-20250707-163722.png

Board

Quick filter name

Refresh Interval

image-20250522-141709.png

 

Possible Error messages

Error Messages

Note

Error Messages

Note

image-20250610-113418.png

Request was malformed.

image-20250610-113541.png

External Share for Jira is not installed in Jira instance.

image-20250610-113643.png

Could not access Issue / JQL / Board data.

Issue might not exists. Issue is fetched as user who created Confluence page or edited Confluence page. If this person has no access to issue then it will not be displayed.