Skip to main content
Curator enables you to embed Power BI reports as a seamless part of your portal, providing your users with a unified analytics experience, streamlining access to critical insights.

​
Prerequisites

Before adding Power BI reports to Curator, ensure you have established your Power BI connection and have reports published to a Power BI workspace.

​
Creating a Power BI Report in Curator

To add a new Power BI report to your Curator portal follow the steps below:
  2. Click the New Report button
    Add new Power BI report from list page
  3. Fill out the details in the Create Power BI Report form:
    Create new Power BI report
    • Workspace: Select the Power BI workspace containing the report.
    • Report: Select the specific report to embed.
    • Title: This appears in navigation menus and page titles - can be different from the Power BI report name.
The display options will allow you to control how the report is scaled (the Display Option), the appearance of the toolbar, the persistence of filters, the appearance of the filter pane as well as the Power BI report Page Navigation.

​
Display Settings Reference

The Display tab controls how the embedded report is scaled and how its page navigation renders: The Report tab exposes the following display toggles:
Not every Power BI SDK setting is surfaced as a Curator option. The following are not currently configurable through Curator’s interface:
  • Zoom level — a programmatic zoom override
  • Bookmarks pane — showing or hiding the bookmarks panel
If you need one of these settings, submit a feature request through your support channel.
Optionally, explore the Discovery tab and the rest of the Display tab (thumbnail and tutorial settings) to further customize how the report appears and is found by users or linked to other content across your site. Be sure to save your report before navigating away from the page.

​
Default Display Option

The Display Option on an individual report (or dashboard) defaults to Global Default, which follows a tenant-wide setting. To set that default:
  2. Set Default Display Option to Fit to Page, Fit to Width, or Actual Size. This value is applied to every embedded Power BI report and dashboard that is left on Global Default.
An individual report or dashboard that specifies its own Display Option overrides this global default. If neither the per-item option nor the global setting is configured, embeds fall back to Fit to Width. As with the per-item option, this default applies to desktop viewports only; mobile viewports always use the oneColumn layout.
Fit to Page applies to reports only. Power BI dashboards do not support the Fit to Page layout, so a dashboard falls back to Fit to Width whenever Fit to Page is the resolved option. For this reason the per-dashboard Display Option offers only Fit to Width and Actual Size.

​
Default Page Navigation Position

The Page Navigation Position on an individual report defaults to Global Default, which follows a tenant-wide setting. To set that default:
  2. Set Default Page Navigation Position to Bottom or Left. This value is applied to every embedded Power BI report that has Page Navigation enabled and is left on Global Default.
An individual report that specifies its own Page Navigation Position overrides this global default. If neither the per-report option nor the global setting is configured, embeds fall back to Bottom, which matches the standard Power BI Service appearance.
Page navigation applies to reports only. Power BI dashboards do not have pages, so this setting has no effect on them, and no Page Navigation Position option appears on a dashboard.
The action bar overrides this setting. When a report has Enable actionbar on, Power BI always places page navigation on the left, and the Page Navigation Position value is ignored for that report — this is a Power BI platform limitation, not a Curator setting. To use Bottom (or to switch to Left yourself), disable the action bar on the report. See Microsoft’s embedded report settings limitations.

​
Mobile Layout

When the viewport is 768px or narrower, Curator automatically switches Power BI reports to the mobile-optimized MobilePortrait layout and oneColumn page view. This overrides the configured Display Option, which only applies to desktop viewports. The mobile layout uses the layout authored in Power BI Desktop or the Power BI Service. If a report does not have a mobile layout, Power BI falls back to the standard landscape layout.
To take full advantage of this feature, author a mobile layout for your Power BI report in Power BI Desktop/Service. Without one, the report will still render on mobile but will use the default desktop layout scaled to fit the screen.
Power BI dashboards also switch to oneColumn page view on mobile viewports but do not use MobilePortrait since dashboards do not support mobile layouts.

​
Adding Reports to Navigation

After creating a report, add it to your site’s menu for easy access and automated authorization.

​
Adding Reports to Pages

Once a Power BI Report has been added to Curator it can also be added to pages for a more dynamic layout. Embed Power BI reports in custom pages using the Page Builder.

​
Security Considerations

Curator utilizes the permissions set within your Power BI tenant including both workspace-level permissions as well as direct-access permissions.

​
Workspace-Level Access

When a user has access to a workspace, they automatically have access to all reports within that workspace. Curator checks workspace access to determine report visibility. Due to performance concerns we strongly recommend utilizing workspace-level access whenever possible.

​
Direct Report Access

If a user does not have access to a workspace, Curator will check for direct access permissions to individual reports. This allows for more granular control over report access but can lead to performance issues due to limitations in the Power BI APIs.