Suppose you have built a beautiful Power BI report that shows sales performance by region or monthly HR headcount trends. Your team loves it. But here is the problem: every time someone wants to check the numbers, they have to open Power BI separately, log in, find the report, and then switch back to whatever they were doing.
Now imagine embedding that same report directly into your company’s Power Pages portal. Your employees or external users open the portal, navigate to the right page, and the report is just there, live, interactive, and filtered exactly to what they need to see. No extra logins. No switching tabs.
In this tutorial, I will show you, step by step, how to display a Power BI report on a Power Pages site. And if this is your first time doing it, I will also walk you through the common errors you are likely to hit along the way and exactly how to fix them.
What You Need Before You Start
Before we jump in, make sure you have these in place:
- A Power Pages site already created (a trial site works fine for practice)
- A Power BI report published to a workspace, not your personal “My Workspace.”
- A Microsoft 365 account with a Power BI Pro or Premium Per User license
- Global Admin or Power Platform Admin access, you will need this to enable settings in the admin centers
If you are missing the Power BI Pro license, you can start a free trial directly from the Power BI service.
3 Various Ways to Display Power BI Reports in Power Pages
Power Pages gives you three ways to embed a Power BI report.
1. Embed for Your Customers
Also called App Owns Data. The application authenticates with Power BI, not the individual user. Your portal users do not need a Power BI license.
Use this when:
- You are building an external-facing portal for customers or partners
- Your users are not part of your Microsoft 365 organization
- You want users to view reports without needing a Power BI login
What you need:
- An Azure Active Directory app registration
- Power BI Premium or Embedded capacity (A SKU or P SKU)
- A service principal with access to the workspace
2. Embed for Your Organization
Also called User Owns Data. Each user signs in with their own Microsoft 365 account to view the report. They can only see reports they already have access to in Power BI.
Use this when:
- You are building an internal portal for your employees
- All your users are part of your Microsoft 365 organization
- Your users already have Power BI Pro or Premium Per User licenses
What you need:
- Users must have a Power BI Pro or PPU license
- The report must be in an organization workspace — not “My Workspace”
- Power BI Embedded Service must be enabled in the Power Pages Admin Center
3. Publish to Web
The simplest option. Power BI generates a public embed link — anyone with the link can view the report without logging in.
Use this when:
- The data is fully public — no sensitive or confidential information
- You want a quick, zero-configuration embed on a public-facing page
Note: Never use Publish to Web for reports containing internal data, employee information, or financials. Once published, the data is accessible to anyone — even outside your organization.
How to Display Power BI Reports in Power Pages
Now I will walk you through the steps to display a Power BI report in Power Pages.
Step 1 — Enable Power BI in Power Platform Admin Center
This is the first setting you need to turn on. Most people skip this and then wonder why things are not working.
- Go to admin.powerplatform.microsoft.com
- Click Environments and select your environment
- Click Settings from the top menu
- Go to Product → Features
- Scroll down to the Power BI section
- Toggle ON both options:
- Power BI visualization embedding
- Click Save

This step tells your Power Platform environment that you want Power BI to work here.
Step 2 — Enable Power BI in Power Pages Admin Center
Now you need to tell your specific Power Pages site to allow Power BI. This step directly fixes the error “Power BI is not enabled for this portal,” which you will almost certainly see if you skip it.
- Open your site in Power Pages Studio
- Add Power BI -> Edit Power BI
- Click Open admin center — this opens the Power Pages Admin Center

- In the admin center, find the Services section
- You will see two options — enable both:
- Click Enable Power BI Visualization → confirm the pop-up. The portal will restart for a minute or two — that is completely normal.
- Click Enable Power BI Embedded Service → select the Power BI workspace you want to connect to

After the portal restarts, go back to Power Pages Studio. The error will be gone and you can now add the Power BI component.
Step 3 — Configure Settings in Power BI Admin Portal
This step is required for the Embedded Service method. You need Power BI Admin access to do this.
- Go to app.powerbi.com
- Click the Settings icon (top right) → select Admin portal
- Click Tenant settings
- Scroll to Developer settings and enable:
- Allow service principals to use Power BI APIs — enable for your entire organization or a specific security group
- Embed content in apps — enable this as well
- Click Apply

These settings allow Power Pages to securely communicate with Power BI in the background to serve the embedded report.
Step 4 — Set Up Your Power BI Workspace Correctly
You cannot use your personal workspace, “My Workspace,” with Power Pages. You must use an organization workspace.
Here is how to check and fix this:
- Go to app.powerbi.com
- On the left, click Workspaces
- If you only have “My Workspace”, create a new one — name it something like Company Reports

- Open the workspace → click Manage access
- Add your admin account as Admin
- If your report is currently in “My Workspace”, open it in Power BI Desktop and republish it to this new organization workspace

Your report is now in the right place for Power Pages to connect to it.
Step 5 — Add the Power BI Component in Power Pages Studio
- Open Power Pages Studio and navigate to the page where you want the report to appear
- Click the + (Add section or component) button
- From the component list, select the Power BI component
- The component will appear on the page — click Edit Power BI from the toolbar above it
- Then you will see 3 options:
- Embed for your customers
- Embed for your organization
- Publish to web

Embed for your customers
When you select Embed for Your Customers, Fill in the following fields:
- Workspace (required) → Select the organization workspace where your report lives. In this example, it is Company Reports
- Type → Choose between two options:
- Dashboard — embeds a full Power BI dashboard
- Report — embeds a specific Power BI report (this is the most commonly used option)
- Report (required) → Pick the report you want to display. In this example it is Project Management KPI
- Page → Select which page of the report to show. For example Page 1
- Apply roles → Toggle this ON only if you have set up Row-Level Security roles in Power BI and want to restrict what data each user sees
- Apply filter → Toggle this ON if you want to pre-filter the report when it loads — for example, automatically showing only data for a specific region or department
Once you have filled everything in, click Done.

Then click Save and Sync at the top of Power Pages Studio to publish the changes to your portal.

Tip: The Type dropdown is important if you select Dashboard, the Report dropdown changes to show dashboards instead of reports. Make sure you select the correct type first before choosing your report or dashboard name.
Embed for Your Organization
When you select Embed for Your Organization, Fill in the following fields:
- Workspace (required) → Select the organization workspace where your report is published. In this example, it is Company Reports
- Type → Choose between:
- Dashboard — embeds a Power BI dashboard
- Report — embeds a Power BI report (most commonly used)
- Report (required) → Select the report you want to display. In this example it is Project Management KPI
- Page → Choose which page of the report to show — for example Page 1
- Apply filter → Toggle this ON if you want the report to load with a pre-applied filter — for example, automatically showing data for a specific department or date range

Once done, click Done → then Save and Sync in Power Pages Studio.
Note:
Before your users can view the report on the portal, you need to share the report with them in Power BI or add them to the workspace with at least a Viewer role. Otherwise, they will see an access denied error when the report loads.
Publish to web
When you select Publish to Web, the panel looks quite different from the other two options. You will notice a warning message at the top:

Power Pages is reminding you that this method has no security. Take that warning seriously. Only use this option for reports that contain completely public data.
The panel has just one field: Embed Code URL. You need to get this URL from Power BI first. Here is how:
Step 1 — Get the Embed URL from Power BI
- Go to app.powerbi.com
- Open the report you want to embed
- Click File from the top menu
- Click Embed report → Publish to web (public)
- A pop-up appears — click Create embed code

- Power BI will show another warning saying the report will be public — click Publish
- Power BI generates a link and an embed code — copy the Link (the URL that starts with https://app.powerbi.com/view?r=…)

Step 2 — Paste the URL in Power Pages
- Go back to Power Pages Studio
- Click Edit Power BI on your component
- Select Publish to web as the Access type
- Paste the copied URL into the Embed Code URL field
- Click Done

That is it. Your report is now embedded and visible to anyone who visits that page no login, no license required.

Note:
Important: If the Publish to web option is missing or grayed out inside Power BI, it means your tenant admin has not enabled it. Ask your Power BI admin to go to:
Power BI Admin Portal → Tenant Settings → Export and sharing settings → Enable Publish to web
Conclusion
In this tutorial, I showed you how to display a Power BI report in Power Pages from start to finish.
We started by enabling the required settings in the Power Platform Admin Center and Power Pages Admin Center. Then we set up the Power BI workspace correctly and added the Power BI component in Power Pages Studio.
I also covered all three embed methods — Embed for Your Customers, Embed for Your Organization, and Publish to Web — with the exact fields and steps for each one.
You may also like:
- Set Up Google Login in Power Pages
- Add a Card Gallery in Power Pages
- Add a List in Power Pages [CRUD Operation]
- Add a Multistep Form in Power Pages

Hey! I’m Bijay Kumar, founder of SPGuides.com and a Microsoft Business Applications MVP (Power Automate, Power Apps). I launched this site in 2020 because I truly enjoy working with SharePoint, Power Platform, and SharePoint Framework (SPFx), and wanted to share that passion through step-by-step tutorials, guides, and training videos. My mission is to help you learn these technologies so you can utilize SharePoint, enhance productivity, and potentially build business solutions along the way.