> ## Documentation Index
> Fetch the complete documentation index at: https://docs.curator.interworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding a Power BI Report

> Add and configure Power BI reports in Curator for seamless access via embedding.

export const BackendNavPath = ({levelOne, levelTwo, levelThree, tab, section}) => {
  const levels = [levelOne, levelTwo, levelThree].filter(Boolean);
  const lastLevel = levels.length ? levels[levels.length - 1] : '';
  return <span>
      In the <a href="/setup/installation/linux_installation">backend of Curator</a> using the left-hand navigation,
      navigate to the
      {levelOne && <strong>{" " + levelOne}</strong>}
      {levelOne && levelTwo && " > "}
      {levelTwo && <strong>{levelTwo}</strong>}
      {levelTwo && levelThree && " > "}
      {levelThree && <strong>{levelThree}</strong>} page.
      {(tab || section) && <>
          {" "}On the {lastLevel} page
          {tab && <> click the <strong>{tab}</strong> tab</>}
          {tab && section && " and"}
          {section && <> expand the <strong>{section}</strong> section</>}.
        </>}
    </span>;
};

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](/creating_integrations/power_bi_connection/curator_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:

### Navigate to Power BI Reports

1. <BackendNavPath levelOne="Power BI" levelTwo="Reports" />
2. Click the **New Report** button
   <Frame>
     <img className="rounded-xl" src="https://mintcdn.com/interworks/g2o1CqLP2qwX5o12/assets/images/embedding_using_analytics/power_bi_reports/pbi_report_new_report_empty_list_page.png?fit=max&auto=format&n=g2o1CqLP2qwX5o12&q=85&s=2afa52b381f27109792bfe5ade13b7e0" alt="Add new Power BI report from list page" width="4320" height="2688" data-path="assets/images/embedding_using_analytics/power_bi_reports/pbi_report_new_report_empty_list_page.png" />
   </Frame>
3. Fill out the details in the **Create Power BI Report** form:

   <Frame>
     <img className="rounded-xl" src="https://mintcdn.com/interworks/g2o1CqLP2qwX5o12/assets/images/embedding_using_analytics/power_bi_reports/pbi_create_new_report_edit_report_page.png?fit=max&auto=format&n=g2o1CqLP2qwX5o12&q=85&s=4e31984c27f6b002260ef81020e05504" alt="Create new Power BI report" width="4320" height="2688" data-path="assets/images/embedding_using_analytics/power_bi_reports/pbi_create_new_report_edit_report_page.png" />
   </Frame>

   * **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 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 Report tab exposes the following display toggles:

| Setting                       | Description                                                                                                                                                                                        | Default |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| **Show filter pane**          | Show or hide the collapsible filter pane on the report.                                                                                                                                            | On      |
| **Page Navigation**           | Show or hide the page navigation controls on the report.                                                                                                                                           | On      |
| **Enable actionbar**          | Show or hide the Power BI action bar.                                                                                                                                                              | Off     |
| **Enable persistent filters** | Preserve a user's filter selections between sessions.                                                                                                                                              | Off     |
| **Enable Copilot**            | Show the Power BI Copilot pane. Enabling it automatically enables the action bar — see [Enabling Copilot](/embedding_using_analytics/power_bi_reports/enabling_copilot) for the full requirements. | Off     |

<Note>
  Not every Power BI SDK setting is surfaced as a Curator option. The following are **not** currently configurable
  through Curator's interface:

  * **Status bar / zoom slider** (`bars.statusBar.visible`) — the zoom control rendered at the bottom of a report
  * **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.
</Note>

Optionally, explore the Discovery and Display tabs 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.

## 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 uses the mobile 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.

<Note>
  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.
</Note>

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](/site_content_design/menus/menu_items) 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](/site_content_design/pages/power_bi_report).

## 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.