How to Add a Power BI Component in Microsoft Power Pages

Add a Power BI Component

The Power BI Component allows you to embed interactive dashboards and reports directly into Microsoft Power Pages. This integration enables users to view business insights, monitor performance metrics, and analyze data without leaving the portal experience.

Prerequisites

Before adding a Power BI component, ensure that Power BI integration is enabled for your Power Pages website and that the required workspaces, reports, and dashboards are accessible to the appropriate users.

How to Add a Power BI Component

Open Design Studio and navigate to the page you want to edit.
Select the page where the Power BI content will be displayed.
Choose the section where you want to add the component.
Hover over an editable area and select the Power BI icon from the component panel.
Select Edit to configure the Power BI component.
Provide the required settings in the properties pane.
Save and publish your changes.

Tip: Choose the appropriate access type based on your audience and security requirements before publishing Power BI content.

Power BI Component Properties

Property	Description
Access Type	Determines how users can access Power BI content.
Workspace	Select the Power BI workspace containing the dashboard or report.
Select Type	Choose whether to display a Dashboard or Report.
Apply Roles	Specify security roles for reports using role-based security.
Apply Filter	Preload reports using filter expressions.
Embed Code URL	Used when publishing Power BI content to the web.

Power BI Access Types

Embed for Your Customers

This option securely shares dashboards and reports with external users who don't have Power BI licenses or Microsoft Entra authentication. It relies on Power BI Embedded services and supports role-based security and report filtering.

Important: If a page allows anonymous access, embedded dashboards may become publicly visible. Configure page permissions carefully to protect sensitive information.

Embed for Your Organization

This option is designed for authenticated Microsoft Entra ID users. Only users with appropriate workspace access can view the embedded content.

Publish to Web

Publish to Web makes dashboards and reports publicly accessible to anyone on the internet without authentication.

Warning: Do not use Publish to Web for confidential or sensitive business data. Ensure compliance with your organization's security and data-sharing policies.

General Considerations

Performance may be affected when users have access to many workspaces.
Paginated Power BI reports are not supported.
Shared datasets from different workspaces are not supported.
Changes to Power Pages settings may require reloading Design Studio.
User access updates may take time to appear in Design Studio.
The powerbi-client JavaScript library can be used for advanced customization.

Best Practices

Use role-based security whenever possible.
Restrict access to sensitive reports and dashboards.
Choose the correct access type based on your audience.
Test report performance before publishing.
Use report filters to display relevant data.
Regularly review workspace permissions and security settings.

Summary

The Power BI Component enables organizations to integrate powerful analytics and reporting capabilities directly into Microsoft Power Pages. By selecting the appropriate access method, configuring security settings, and following best practices, you can deliver secure and interactive data experiences to your users.