Plans: Free, Starter, Business, Education, and Enterprise plans
People: Company admins, team admins
Platforms: Browser, Desktop
The Power BI integration lets users embed Power BI reports and dashboards in Miro boards. This guide covers setup, the integration's technical implementation, security model, and data handling for admins evaluating or configuring the integration.
Key features
- Live embed: Users can embed a Power BI report or dashboard into a Miro board as a live iframe.
- Secure: Every board visitor is prompted to log in to the iframe before they can view the embedded content.
- Display options: Users can choose to display embedded content as a live embed or as a bookmark.
- Focus mode: Users can expand a live embed or bookmark into focus mode to view it without distractions.
- Action shortcut: Users can add an action shortcut that opens a dialog for embedding a Power BI link.
- Asset picker: Users can add a specific report visual as a static image on the board, so collaborators can view and reference that exact content without needing access to the source file.
- Admin controls: Admins can prevent users from using the asset picker to add Power BI content as static images.
Requirements and limitations
Requires a Power BI Cloud subscription. Supported subscriptions:
- Power BI Premium per capacity SKU
- Fabric Capacity Reservation SKU
Limitations:
- Embedding dataset links isn't supported.
- Embedding the "Dashboard" type isn't supported.
- Share menu links are supported for report visuals only.
- Images added from the asset picker can't be refreshed (this functionality is under construction).
- Embedding on public boards isn't possible.
Set up the Power BI integration
Prerequisites
- A Company admin has approved the Power BI integration for your Miro organization.
- You have Microsoft Entra admin access, to approve the integration for your Microsoft tenant.
Approve the integration in Microsoft Entra
The current version of the Miro Power BI app requires admin consent to install in a customer's Microsoft tenant.
- Log in to Microsoft Entra as an admin and go to Enterprise applications > Consent and permissions.
- Set Yes for Users can request admin consent to apps they are unable to consent to.
- Under Who can review admin consent requests, choose the users, roles, or groups who should be allowed to review these requests.
- Once this is configured, a non-admin user can paste a Power BI link to a Miro board (on a team enabled for the integration) to trigger an approval request.
- The admins selected in step 3 can go to Enterprise applications > Admin consent requests to review and approve the request. Once approved, the integration becomes available for any user in the tenant to authorize on their own.
Install and authorize the integration in Miro
NOTE: Only Miro team admins can install the app. If your Miro organization only allows approved apps, and a regular user pastes a Power BI link, that user sees an app install request dialog instead.
- Copy the Power BI report or dashboard URL.
- Paste the URL onto your Miro board.
- What happens next depends on who pasted the link:
- A Miro team admin pastes the link: The app is authorized and installed automatically, and the link unfurls without further action.
- A regular user pastes the link, and the organization only allows approved apps: An app install request dialog opens. After the user requests permission, company admins can follow the App request flow article to approve the request.
Connect a Power BI account
After the integration is installed and authorized:
- Click Connect on the widget created after pasting the URL on the board. You're redirected to a page asking you to grant Miro access to your Power BI account.
- Confirm authorization on the Microsoft side. A dialog opens where you can select which charts to embed; select a chart and click Add chart. The content is added to your board.
Technical implementation
Miro integrates with Power BI through the Power BI REST API together with the Power BI embedded analytics client APIs. Users authorize access with OAuth 2.0, then link their Power BI reports or dashboards to a Miro board.
Security considerations
The integration's asset picker lets users attach part of a Power BI report to the canvas as a static image. Only authorized users can access the live embed, but anyone with access to the board can view an attached static image. Adding assets from embeds is disabled by default on public boards.
Company admins can disable the asset picker for all boards:
- Go to Company settings > Apps and integrations > Apps > Power BI (under the Manage apps tab).
- Toggle Prevent users from adding assets from embeds to the canvas.
Data flows
- A user who belongs to a team or organization with this feature enabled pastes a Power BI link onto a Miro board.
- Miro reads the link. If the user hasn't authorized the integration yet, Miro starts the OAuth flow and redirects the user to Microsoft's authorization page.
- After the user grants authorization, Miro's integration service uses the user's access token to call the Power BI REST API and retrieve the content.
What Power BI data Miro stores
Miro fetches and stores the following data from pasted Power BI links:
- Images of tiles from Power BI dashboards
- Images of visuals from Power BI reports
- Titles of Power BI dashboards, reports, visuals, and tiles
- Page names from Power BI reports
- Filter names and values from Power BI reports
- Images created by the asset picker
Data retention
Embedded data follows Miro's standard data retention policy for all customer data.
Authentication and authorization
Embedding a Power BI link on a board requires the user to authorize the integration through Microsoft's OAuth API. This also requires a Microsoft Entra admin to approve the integration — see Approve the integration in Microsoft Entra above.
Required authorization scopes
The Power BI integration requires the following scopes:
-
offline_access— required to refresh tokens. -
https://analysis.windows.net/powerbi/api/Dashboard.Read.All— required to read all dashboards. -
https://analysis.windows.net/powerbi/api/Dataset.Read.All— required to read all datasets. -
https://analysis.windows.net/powerbi/api/Report.Read.All— required to read all reports. -
https://analysis.windows.net/powerbi/api/UserState.ReadWrite.All— required for persistent filters.
What's stored in Miro and how
Miro stores two categories of data for this integration: authorization data and unfurling data.
Authorization data: Miro stores the access token and refresh token in its database for several days. While the authorization is active, Miro automatically refreshes an expired access token using the refresh token, without requiring the user to reauthorize. All data stored for this integration is encrypted at rest using 256-bit AES.
Unfurling data: Miro stores two kinds of unfurling data: the images captured by the asset picker (stored as part of the board) and the titles and image references (stored encrypted in an internal service).
Revoking a token
Microsoft Entra admins can revoke the integration's access — see Microsoft's guide to revoking application access.
Frequently asked questions
How do I turn off the integration?
A Microsoft Entra admin can revoke the Miro integration's permissions by deleting the app: go to Enterprise applications > All applications, select the Contenthub Power BI Integration application, then Properties > Delete.
Which users can embed Power BI content into Miro?
The user and the Miro board must meet both of these criteria:
- The user has authorized the Miro Power BI integration.
- The user has access to the Power BI content they're trying to embed.
Which users can view the embedded Power BI content?
Anyone with access to the Miro board and permission from the owner of the embedded content — that is, anyone with view, comment, or edit permissions on the board. Viewers don't need to authorize the integration or hold a Power BI license to view the embedded content on the board.
Do users have to reauthorize to paste links on other boards?
No, as long as the authorization is still valid (Miro treats an authorization as valid for a month after it's granted). Users can paste Power BI links on any board, and the content imports normally.
If the board belongs to a different team or organization where this integration isn't enabled, the user can't use it there.
Can I access Power BI content through Miro that I can't access directly in Power BI?
No. You can only embed Power BI content you already have access to — you can't use the integration to see something you couldn't otherwise open in Power BI. That said, if someone with access has already embedded the content as a static image on a board you share with them, you can view that snapshot even without direct access to the source file. The integration doesn't enforce any additional access policies beyond this; use the Miro board's own sharing settings to restrict who can collaborate. Note that a static image snapshot can't be used to explore the underlying data, open the original report, or change filters.
Where can I find the Miro Data Processing Addendum?
See the Miro Data Processing Addendum.
What's disallowed on public Miro boards?
For security reasons, public boards disable:
- Asset extraction — supported by the Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel, and Microsoft PowerPoint integrations.
- Direct asset unfurling (asset instead of live embed) — supported by the Figma integration.
How can I restrict board access to the same people who have access to the source file?
The integration only manages file access from the source system (Power BI), not from Miro. By default, this isn't enforced — to maintain this level of security, Miro organization admins must disable the asset picker in the app's admin settings (see Security considerations).
Disabling the asset picker prevents Power BI content from being saved as static images on a Miro board, where it could later be seen by people who don't have access to it in Power BI (for example, if the board is shared publicly or with people who lack source access).