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.
✏️ Note that Miro has two types of Jira integrations: Jira add-on (which allows embedding Miro boards on the Jira side) and Jira Cards. To learn more about Jira Cards, visit this article.
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 notauthorized in Miro, you'll need to sign in first.
Set the sharing settings of the board in the drop-down menu. You can make the board available for viewing and commenting so that the users who do not have a profile in Miro can also access it.
✏️ For Enterprise plan Miro users, your access settings will follow organization-wide access controls which might imply that some sharing options may be restricted. Learn more: Managing Enterprise sharing policy for embed integrations.
Sharing settings when attaching a board to a Jira issue
Note that you can only embed boards on which you have Editor access.
Your board is now attached to the chosen Jira issue:
Miro board attached to a Jira issue
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 button to go to Miro app
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 attached board
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 Jira add-on.
Go to a Jira issue and simply paste a board link or type /link to insert. 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.
Frequently asked questions
- Can I hide the Miro boards section in Jira issues?
- Yes, click the three dots in the upper-right corner of the section and choose Hide Miro boards.
Hiding Miro boards in Jira
- Does the add-on work in Jira Next-gen projects?
- Yes, you can attach your boards to such projects.
- Is there an additional cost for Jira add-on?
- Jira add-on is available for all paid accounts at no additional cost (Team, Business, Consultant, and Enterprise plans).
- We're going to migrate Jira from one cloud instance to another. Will Miro boards embedded in Jira issues be affected?
- There should be no issues with embedded Miro boards if the content is moved without changes.