Warsaw Dynamics
Advanced search
Log in
Warsaw Dynamics
Search
Jump to section
    Navigation
    Details
    Page options
    Subscription
    Account
    Log in
    0/0
    Jira Macro Integration
    External Share for Confluence
    Welcome to External Share for Confluence Macro Integration Supported Macros & Formatting 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: https://support.atlassian.com/confluence-cloud/docs/insert-the-jira-issues-macro/?utm_source=chatgpt.com

    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

    /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

     

    Jira Work Items View

    The Jira work items macro can be rendered on a shared page in two ways.

    View

    Result on shared page

    External Share for Jira view

    The macro is rendered by External Share for Jira as an interactive table.

    Confluence view

    The macro is rendered as a standard, static Confluence table.

    This setting applies to the Jira work items macro only. All other Jira macros on this page are not affected by it.

    Where to set it

    Level

    Location

    Effect

    Single share

    Share link settings → Content tab → Integrations

    Applies to that share only.

    Space

    Space Configuration → Content tab → Integrations

    Controls whether the option is available for shares in this space. When cleared, the option in share link settings is greyed out with the tooltip Disabled by parent configuration.

    Space

    Space Configuration → Defaults tab → Jira Work Items view

    Sets whether the option is preselected on newly created shares. Selected — preselected. Empty — not preselected.

    Both External Share for Confluence and External Share for Jira must be installed for the External Share for Jira view. See How it Works above.

    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.

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

    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

     

     

     

    /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

    /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

     

    /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
    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.

     

    About us
    Our apps

    © Warsaw Dynamics, 2025. All rights reserved.