Jira Add-on

Available on: Team, Business, Consultant and Enterprise plans;
Jira Cloud only

Visualize anything together with your team — work on the product backlog with digital sticky notes, create flowcharts, diagrams and wireframes. Attach boards to Jira issues and collaborate with your team in real-time like on a whiteboard meeting.

✏️ You can also embed Miro boards with the Atlassian Smart link feature.

How to install

The installation process is standard for all Jira add-ons.
First, log into your Jira with administrative rights, then download the add-on here (the app can also be found at the Atlassian Marketplace > Find new apps > Miro for Jira Cloud): click Get app and Get it now.
And that's all! The installation is complete.

Jira notification about the successful installation

Please note that as an administrator you don't need to map Miro users to Jira users during setup. Each user will have to authorize themselves in Miro within Jira.

How to use the add-on

Attaching boards to Jira issues

To attach a board to a Jira issue, open the issue in Jira. Click Add Board in the Miro boards section.

The add-on button appears after the installation

💡 If you don't have the Miro boards section, find it in the context menu of the issue.

Adding the Miro boards section to a Jira issue

You will see a picker with Miro boards. Choose the board you wish to add (feel free to switch between your teams in the picker). If you're not authorized in Miro, you'll need to sign in first.

Set the sharing settings of the board in the drop-down menu. You can now make a board available for viewing and commenting so that the users who do not have a profile in Miro can also access it.

Sharing settings when attaching a board to a Jira issue

Your board is now attached to the chosen Jira issue:

The Jira issue that has an attached board

Creating new boards from Jira

To create a new board right from a Jira issue, click Add board and create a New board from the picker.

Creating a board from the picker

Viewing, commenting and editing boards

Simply click an attached board to view/comment/edit it depending on the set access rights. The board window will open as an overlay allowing you to work and collaborate as if you were in Miro.

Board's overlay in Jira

You can also click the source button to open the board in Miro in a new tab for your convenience.

The source button

Detaching boards

To detach a board, simply click on the cross icon and the attachment will be instantly removed from the issue (on the Miro side the board will be unaffected).

The option to remove the attachment

How to disable the add-on

To disable integration, open Atlassian Marketplace > Manage apps > open page of the add-on, and click Uninstall:

The option to Uninstall in the Jira add-ons section

Atlassian Smart Link for Miro

You can embed Miro boards into Jira issues using the Atlassian Smart Link feature. The feature allows you to automatically embed a board without the need to install a plugin. Please note that only those users who have access to the embedded board on the Miro's side will be able to work with the preview after connecting their Miro and Atlassian accounts. If you'd like to make the preview available for all Jira users, feel free to use the Add-on.

If you use the feature for the first time, you will be asked to connect your Miro account. Click Connect to preview, authorize in Miro, and choose a team from which you will embed your boards.

Choosing a team to embed boards from

When you paste a Miro board's link into a Jira issue, it will turn into a Jira widget automatically. Click the link and you will see the options to display the link as a card or as an embed.

The options to display a Miro board link as a link, card, or embed

If you choose to display the board as an embed, you can change the embed size by dragging its side.

Changing Miro embed size in Jira

⚠️ If third party cookies are blocked in your browser there can be unexpected issues displaying embedded boards.

Articles in this section

Contents:

How to install