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

# How to Display a Power BI Dashboard on Digital Signage Using Pickcel?

> Connect your Microsoft Power BI report to Pickcel and display live business intelligence dashboards on your digital signage screens.

This guide shows you how to display a Microsoft Power BI dashboard on your digital signage screens, perfect for showcasing business intelligence, data visualizations, and key performance indicators.

## Prerequisites

Before you begin, make sure you have:

* A Microsoft account with access to the target Power BI report
* The full report URL copied from your browser
* 2-Factor Authentication (2FA) enabled on the account, with the secret key saved

<Info>
  See our guide: [How to Set Up 2FA and Get a Secret Key](/apps/dashboard-apps/2fa-setup)
</Info>

<Warning>
  This integration requires a direct Microsoft account login with an email and password. Federated login methods such as signing in with a Google, work/school Microsoft account, or Apple account are not compatible. Use an account with basic authentication credentials.
</Warning>

<Tip>
  **Best Practice:** For security, use a dedicated Microsoft service account with **Viewer** permissions on the specific Power BI workspace or report you want to display.
</Tip>

***

## Step-by-Step Configuration

<Steps>
  <Step title="Navigate to Apps and search for the Dashboard app">
    In the Pickcel Console, expand **Content** in the left menu and select **Apps**. Search for **Dashboard** and click the Dashboard app card.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/Pickcel_Dashboard_Apps/dashboard-app-power-bi/powerbi-01-search-dashboard-app.9G8CMbW58PtZ.png" alt="Pickcel Apps page with Dashboard searched and the Dashboard app card shown" />
    </Frame>
  </Step>

  <Step title="Create the app and select Power Bi as the dashboard type">
    Click **Create App** in the top-right corner. Enter a name for this app instance, then select **Power Bi** from the **Select the Dashboard Type** dropdown. The **Power Bi Dashboard Configuration** panel opens on the right side of the screen.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/Pickcel_Dashboard_Apps/dashboard-app-power-bi/powerbi-02-create-app-select-type.wcFY_DJb_fUP.png" alt="Dashboard app creation page with Power Bi selected in the dropdown and the configuration panel open on the right" />
    </Frame>
  </Step>

  <Step title="Enter your Power BI Dashboard URL">
    In the **Dashboard URL** field on the right panel, paste the full URL of the Power BI report you want to display. Copy it directly from your browser's address bar while viewing the report in Power BI.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/Pickcel_Dashboard_Apps/dashboard-app-power-bi/powerbi-03-enter-dashboard-url.XRWem3ofHiZJ.png" alt="Power Bi Dashboard Configuration panel with a report URL entered in the Dashboard URL field" />
    </Frame>
  </Step>

  <Step title="Fill in your Microsoft credentials and generate the Auth Token">
    Complete the remaining fields in the configuration panel:

    * **Microsoft Email**: The email address for your Microsoft account.
    * **Microsoft Password**: The password for that account.
    * **Authenticator Secret**: The 2FA secret key you saved when setting up 2FA.

    Once all fields are filled, click **Generate Auth Token**. The token is generated and automatically populated in the **Auth Token** field on the left.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/Pickcel_Dashboard_Apps/dashboard-app-power-bi/powerbi-04-fill-credentials.bChPAy54zu2s.png" alt="Configuration panel showing all fields filled including Microsoft email, password, Authenticator Secret, with Generate Auth Token button highlighted" />
    </Frame>
  </Step>

  <Step title="Enter the Screen Selection Code">
    After the Auth Token is generated, use the **Pickcel Dashboard Screen Mapper** Chrome extension to select the exact area of the dashboard you want to show on screen. Once you confirm the selection, the code is copied to your clipboard. Paste it into the **Screen Selection Code** field.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/Pickcel_Dashboard_Apps/dashboard-app-power-bi/powerbi-05-auth-token-screen-selection.8UNag_qeTnCW.png" alt="App configuration showing the generated Auth Token and the Screen Selection Code field filled in" />
    </Frame>

    <Info>
      For a detailed walkthrough: [How to Use the Dashboard Screen Mapper Chrome Extension](/apps/dashboard-apps/screen-mapper)
    </Info>

    Click **Open Dashboard** next to the Screen Selection Code field to verify the dashboard loads correctly before saving.
  </Step>

  <Step title="Set Refresh Interval and Session Expiry">
    * **Refresh Interval**: How often the dashboard screenshot is updated. For data that changes daily, **60 minutes** is a suitable value.
    * **Session Expiry**: Forces a fresh login to prevent session timeouts from the service provider. A value of **5 hours** is recommended.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/Pickcel_Dashboard_Apps/dashboard-app-power-bi/powerbi-06-refresh-session-settings.ogOox7LeQTvu.png" alt="Refresh Interval set to 60 minutes and Session Expiry set to 5 hours" />
    </Frame>
  </Step>

  <Step title="Configure auto scroll (optional)">
    If your dashboard is taller than the visible screen area, enable scrolling:

    * **Enable Auto Scroll**: Sets a scroll duration in seconds. The dashboard scrolls from top to bottom over that time. For example, 60 seconds scrolls the full height over one minute.
    * **Enable Auto Scroll Height**: Scrolls down by a fixed number of pixels each cycle.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/Pickcel_Dashboard_Apps/dashboard-app-power-bi/powerbi-07-auto-scroll.49fbXues4Hqe.png" alt="Enable Auto Scroll toggled on with a 60-second duration, and Enable Auto Scroll Height toggled on with 600 pixels" />
    </Frame>
  </Step>

  <Step title="Click Create App">
    Once all settings are configured, click **Create App** in the top-right corner to save the app instance.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/Pickcel_Dashboard_Apps/dashboard-app-power-bi/powerbi-08-create-app.XvpX9CHYzAkG.png" alt="Dashboard app configuration with the Create App button highlighted in the top-right corner" />
    </Frame>
  </Step>

  <Step title="Find the app in Content > Media">
    The new app instance appears in **Content > Media**. Find it by the name you gave it. The type shows as **App**.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/Pickcel_Dashboard_Apps/dashboard-app-power-bi/powerbi-09-media-library.U2swzpGrT3Ag.png" alt="Pickcel Media library showing the PowerBI Dashboard app listed with type App" />
    </Frame>
  </Step>

  <Step title="Preview the dashboard">
    Click the app's thumbnail to open a preview. The Power BI report renders inside the preview modal. If the data looks correct, assign the app to your digital signage screens via a Composition or Quick Play.

    <Frame>
      <img src="https://cdn.pickcel.com/images/pickcel-docs/Pickcel_Dashboard_Apps/dashboard-app-power-bi/powerbi-10-preview.ZW-G4KRXVyZl.png" alt="Preview modal showing the PowerBI Dashboard app with a live Power BI report rendered inside" />
    </Frame>

    <Note>
      The dashboard may take up to 2 minutes to load on first render, depending on the report size and authentication speed.
    </Note>

    <Warning>
      If the credentials are incorrect, the app will stall on the Microsoft login screen instead of showing the dashboard.
    </Warning>
  </Step>
</Steps>

***

## What's Next?

* To create a multi-zone layout: [Compositions](/compositions/compositions)
* To send it to your screens: [Publish or Schedule Content](/schedule-and-publish/publish-overview)