How to add a Jira kanban board to a Confluence page

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Jira Gadget

The Agile Wallboard gadget is a Jira gadget that can be made available in Confluence, but it is not there by default. To use it, you need an application link between Jira and Confluence and the gadget has to be registered in Confluence.

Please see this guide for step by step instructions:  Registering External Gadgets


This document will walk you through all of the steps required to set up an integration between Confluence & JIRA in order to embed a JIRA kanban board onto a Confluence page. 


It's possible to display a kanban board from Jira inside of your Confluence instance through an External Gadget setup utilizing the Agile Wallboard Gadget macro. Utilizing gadgets requires that Confluence and Jira are first integrated through Application Links.

To set up:
    1. First, make sure that the two instances can integrate and talk to each other by creating an Application Link among the systems if one does not already exist.
    2. Grab the Base URL of your Jira instance and head to <confluenceBaseURL>/admin/viewgadgetdirectory.action in Confluence
    3. Click on the Gadget Feeds tab. Paste the JIRA Base URL here and click Add.
    4. Create a test page. Open the macro browser and search for Agile Wallboard Gadget and select it.

      (warning) Due to CONFSERVER-78282 - Getting issue details... STATUS you may not see external gadget(s) until the Allowlist is enabled
    5. From here,  you will need to authenticate through to Jira by clicking the Login & Approve dialog from the configure macro modal.
    6. Configure the kanban board of your choice and save your changes. You should now display the wallboard on the page. 

Last modified on Oct 5, 2022

Was this helpful?

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