Miro and Confluence work together with 2-way sync to ensure that you get the most up-to-date content from both platforms, wherever you work.
Available for: All Miro plans; Confluence Cloud (embedding in Miro), Confluence Cloud/Server/DC (embedding in Confluence)
Who can do it: Confluence Admin
How Miro works with Confluence
Embed your Miro boards and Confluence documents, and keep track of changes with instant syncing. You can set embed access levels so the right users have access to the right information at all times.
Embed Confluence docs in Miro boards
Embed Miro boards in Confluence docs
Embed Confluence docs in Miro boards
You can embed Confluence docs in Miro by simply pasting a link to the Miro board. Note that embedding Confluence docs in Miro requires Confluence Cloud.
When you paste a Confluence link onto a Miro board, it appears as a Miro smart link. When pasting a Confluence link for the first time, you will need to click Connect to authorize Confluence access.
⚠️ For security purposes, we don’t show the details of a Confluence link on public Miro boards, and users can only view the title of a Confluence link on private boards. Users will only see the title of the page when they authorize their Confluence account, after which they'll be able to expand and edit the Confluence document (depending on the access level permissions provided).
Connecting the Confluence page in Miro
Once Confluence is authorized, users who access the board will now be able to see the document Title, Provider icon, and Link source. Users will also be able to expand the Miro smart link to full screen mode.
💡 Miro smart link titles are extracted from the URL. If you edit the title of the Confluence document, you'll need to paste the link again to see the updated title in your Miro smart link.
A connected Confluence page as a Miro smart link
When users click on the expand icon, they will be asked to authorize their own Confluence account before they can view and edit the document within Miro.
The expanded Confluence document
Embed Miro boards in Confluence docs
You can embed Miro boards in Confluence docs with the Miro Plugin for Confluence, or directly via Atlassian Smart Links. This can be done with Confluence Cloud, Server, or DC.
Step 1: Set up the Miro Plugin
First, install the Miro for Confluence app from the Atlassian marketplace.
How to install the Miro for Confluence app
Who can do it: Confluence Admin
- Log into your Confluence instance as an admin
- Click the admin dropdown and choose Add-ons (Apps)
- Select Find new apps or Find new add-ons
- Search Miro for Confluence
- Click Get app
The Miro for Confluence app
You will see the following message when the app has been successfully installed:
The app has been successfully installed
Step 2: Embed a board in the Confluence page
There are three ways to embed a Miro board in a Confluence page:
- By typing /miro directly on the Confluence doc.
Typing /miro on the Confluence page to embed a board - By searching for Miro from the app toolbar. From the Confluence doc, click Insert and select Miro from the list of apps.
Selecting Miro from the app list to embed a board - By pasting a Miro link directly into Confluence with Atlassian Smart Links.
Step 3: Select a board from the board picker
The board picker will open. Select the board you wish to embed from the dropdown, or search for a board. Users will only see the boards available to them in Miro, and can only embed boards if they have editor access to them.
Choosing a board to embed from the board picker
Step 4: Choose the embed permissions
Embed permissions grant users access only to the embedded board on the Confluence page. The access level settings for embedded boards on the Confluence side do not affect the board access level settings on the Miro side. Learn more about board access in embedded apps.
If Allow visitors to collaborate is ON anyone who has access to the Confluence doc can edit, view, and comment on the embedded board.
If Allow visitors to collaborate is OFF users will see the board in view-only mode within the Confluence doc. They cannot edit or comment on the board. It still allows users to zoom in or out, and move around the board for a distraction-free experience.
✏️ For users on the Miro Enterprise Plan, access levels will follow organization-wide access settings, and therefore some permissions may be restricted. Learn more about embedded board management for Enterprise Plan.
Embed access levels
Once you click Embed board the Miro board will be inserted on the Confluence page as an iFrame. Users can navigate around the board and view, comment or edit the board depending on the access level you set in Confluence, as well as the access level they have to the board on the Miro side.
Miro board embedded into a Confluence page
To open the board directly in Miro, click the Miro logo.
User experience in Confluence Cloud vs Confluence Server
The window size menu for embedded boards is different for Confluence Cloud and Confluence Server.
In Confluence Cloud you will see the following window size menu with the option to Go full width:
In Confluence Server you will see a menu with the option to select a small, medium, or large (S/M/L) window size:
Window size menu in Confluence app
Embed Miro boards via Atlassian Smart Links
You can also embed Miro boards in Confluence using the Atlassian Smart Links feature. The feature allows you to automatically embed a board without the need to install an app.
Go to a Confluence page 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 a Miro team. Click Connect to preview, authorize in Miro, and choose a team from which you will embed your boards.
✏️ Only users who have access to the embedded board on the Miro side will be able to work with the embedded Miro board preview after connecting their Miro and Atlassian accounts. If you'd like to make the board preview available for all Confluence users you can use the Miro app.
Choosing a team to embed boards from
When you paste a Miro board link into a Confluence page, it will turn into a widget automatically. Click the link to see the display options. You can choose to display the Miro board as a URL, inline text, a card or an embed.
Miro board widget in Confluence
If you choose to display the board as an embed, you can change the embed size by dragging its sides.
Changing Miro embed size in Confluence
⚠️ If third-party cookies are blocked in your browser there can be unexpected issues displaying embedded boards.
Disabling the Miro app for Confluence
To disable the app go to Atlassian Marketplace > Manage apps > Miro for Confluence Cloud > Uninstall.
Miro for Confluence app on the list of the installed Atlassian apps
