Install and use workspace apps

Applies to: ✅ Power BI service

Workspace apps are the app experience previously and widely called Power BI apps. They package and publish Power BI content from a workspace. Now that you have a basic understanding of workspace apps, learn how to install, open, and interact with them.

Ways to get a new workspace app

You can get a new workspace app:

  • By selecting Get apps from the Apps page in the Power BI service.
  • By using a direct link to an app that you receive from the app designer.
  • When an app designer in your organization installs the app automatically in your Power BI account.

With Power BI mobile, you can only install a workspace app from a direct link. Get apps isn't available in Power BI mobile. If the app designer installs the app automatically, you'll see it in your list of apps.

Note

The new Apps page is available to all users in both the Power BI and Fabric experiences, with a toggle to switch between the new and old pages. To use Gallery view, switch to the old page. For details, see The new Apps page.

Apps and licenses

Not all Power BI users can view and interact with apps. If you have a free license, you can open apps that are stored in Premium capacity or Fabric F64 or greater capacity and that are shared with you. If you have a Pro license or a Premium Per User license, you can open apps that are shared with you.

So, if you can't open an app, contact your administrator or help desk. For information about licensing, see Power BI licensing.

Get a workspace app from the Apps page

Select Get apps from either the new or old Apps page to find and install workspace apps and template apps. You don't need to switch to the old page to use Get apps.

  • A workspace app is available to Power BI users in your organization. These apps can include prebuilt dashboards and reports that you can use as-is or customize and share. Your organization might have apps for things like tracking sales, measuring performance, or analyzing hiring success.
  • A template app comes with pre-built dashboards and reports that you can use to connect to many of the services you use to run your business, such as SalesForce, Microsoft Dynamics, and Google Analytics.
  1. To install an app, sign in to the Power BI service if prompted.

  2. Select Apps, and then select Get apps. The following image shows Apps highlighted in the navigation pane on the new page. Get apps is available on both pages.

    Screenshot of the new Apps page with Apps in the navigation pane outlined in green.

  3. The Get apps experience opens. The following image shows the previous experience.

    Screenshot of the previous Get apps experience.

    Three tabs are available for you to use:

    • All apps - Browse both template apps and all the workspace apps that are available to you. Template apps are distinguished by the shopping bag icon in the upper-right corner of their tiles.
    • Organizational apps - Browse workspace apps that are shared with you. This label uses older terminology in the previous experience.
    • Template apps - Browse template apps that are hosted on AppSource.

    Alternatively, you can use the search box to get a filtered selection of apps. Type part of the name of an app or category, such as finance, analytics, or marketing, to make it easier to find the item you're looking for.

    The search box is sensitive to the tab you have open. Only apps of the selected type are returned. If the All apps tab is open, both workspace and template apps are returned. When a workspace app and a template app have the same name, use the shopping bag icon in the upper-right corner to identify the template app.

  4. When you find the app that you want, select Get it Now to install it.

    Screenshot of the Get it Now button to install an app.

  • If you install a workspace app, it's immediately added to your list of apps.

  • If you're installing a template app, you'll be taken to the template app offering in AppSource.

    Note

    If you're using a free user license, you can download apps but you can't view them unless you upgrade to a Power BI Pro or Premium Per User license or unless the app is stored in a Premium capacity or Fabric F64 or greater capacity. For more information, see Licenses for business users.

You can also install a workspace app from a direct link:

  • On your computer. When you select the link in an email, the Power BI service opens the app in your browser.
  • On your iOS or Android mobile device. When you select the link in an email on your mobile device, the app installs automatically and opens in the mobile app. You might have to sign in first.

The new Apps page

The new Apps page is available to all users, with a toggle to switch between the new and old pages. The Apps page is a single place to find and return to app experiences available to you, including:

  • Workspace apps, which package and publish Power BI content from a workspace.
  • Template apps, which provide prebuilt content you can connect to your data.
  • Org apps, which are Fabric items that package content for consumers in your organization.
  • Fabric Apps (Preview), which are purpose-built Fabric application items.

Sharing isn't the only way to distribute a Fabric App. You can also include it in an org app alongside other content. For details, see Get started with org apps.

Previously, the Apps page was available only from the Power BI experience in the service. It's now available from both the Power BI and Fabric experiences. You can:

  • Open the Apps page from the navigation pane while using the Power BI experience.
  • Open the Apps page from the navigation pane while using the Fabric experience.
  • Use the experience selector to move between the Power BI and Fabric experiences when needed.

Switching experiences doesn't change which apps you can access. The Apps page provides access to your available app experiences from either experience.

The new Apps page uses these item-type labels. Other product surfaces might still use app, Power BI app, or similar older terminology for a workspace app while terminology updates are progressively applied.

App type Label on the new Apps page
Fabric App App
Workspace app Workspace app
Org app Org app

Screenshot of the new Apps page with the Type column outlined in green.

Get apps is available on the new page. You can use it to find and install apps without switching to the old page. Switch to the old page for template-app version browsing or Gallery view.

Use the following pivots to find apps:

  • All shows apps available to you.
  • Recent helps you return to apps you opened recently.
  • Favorites shows apps you marked as favorites.
  • Endorsed in your org shows endorsed apps available to you.

The list experience provides additional app information in columns, column-based sorting, search, filters that include app type, and improved recency-based organization.

The following image shows the new Apps page with its discovery tabs outlined in green.

Screenshot of the new Apps page with All, Recent, Favorites, and Endorsed in your org outlined in green.

Switch to the old Apps page

Use the New apps page toggle on the Apps page to switch between the new and old experiences. Turn it off to use the old page. The page remembers your choice.

On the old page, select the List view icon to show apps in a list or the Gallery view icon to show apps as cards.

Switch to the old Apps page to:

  • Use Gallery view by selecting the Gallery view icon.
  • Browse template apps by version.

Gallery view and template-app version browsing aren't available on the new page. Get apps remains available. In the pictured Get apps marketplace, the Organizational apps tab lists workspace apps, not org app items.

Important

My apps on Power BI Home is separate from the Apps page. At this time, My apps lists only workspace apps; it doesn't list org apps or Fabric Apps. Use the Apps page to find workspace apps, org apps, and Fabric Apps together. An app missing from My apps doesn't mean that you lack access to it.

Interact with the dashboards and reports in the app

Take some time to explore the data in the dashboards and reports that make up the app. You have access to all of the standard Power BI interactions, such as filtering, highlighting, sorting, and drilling down. The extent of what you can do with an app is controlled by the permissions that the designer assigned to you. How you can interact with the app's dashboards and reports is controlled by the access and roles that the designer assigned to you.

Still a little confused by the difference between dashboards and reports? Learn more about dashboards or reports in Power BI.

Open an app

  1. After you install a workspace app or receive access to an app, select Apps from the navigation pane in either the Power BI or Fabric experience. In the new experience, find the app in the list by using the pivots, search, sorting, or filters. In the previous experience, find the app in the list or Gallery view.

    To use Gallery view, turn off the New apps page toggle, and then select the Gallery view icon. The following image highlights the toggle turned off and the selected Gallery view icon.

    Screenshot of the old Apps page with the New apps page toggle turned off and the selected Gallery view icon outlined in green and connected by a green arrow.

    The following image shows an app card in the previous experience.

    Screenshot of a workspace app card in the previous Apps page experience.

  2. Select the app to open it. Depending on the app, you might receive a prompt that looks similar to the following example. Some apps ask you for contact information (name and email) or for product details (customer ID, subscription number, or parameters). Many apps load with sample data and provide a link for you to connect your own data. For guidance on which option to select, see Install template apps.

    Screenshot of the Get started page for a new app with the options Connect, Explore app, and Edit workspace.

  3. The Sales and Marketing Sample app opens to a report. The layout might look different if your app opens to a dashboard. If you select a report in the dashboard, the layout will look like the following example.

    Screenshot of the Sales and Marketing app with different areas identified by numbers.

Apps have different layouts, visuals, colors, and options, but they all have most of the features shown in this example:

  1. Name of the app and last updated time. Select the dropdown arrow to look up the owner and Help contact.
  2. Select Power BI to return to Home.
  3. Your menu bar.
  4. The report page canvas.
  5. The app navigation pane. Below the name of the app is the list of content. This app has one report with six pages. Select a report page name to open it. We currently have the Return rate page open.
  6. Select the arrow to expand the Filters pane.

You can explore the associated workspace if you get access. When you install or download a template app, the Power BI service creates a workspace for you. When you install a workspace app, it might not include access to the workspace. For more information, see Collaborate in workspaces. Select Power BI (number 2) to return to Home and choose Workspaces.

Screenshot of the Sales and Marketing workspace showing one report and one semantic model.

Share reports and dashboards from an app

You can share reports and dashboards that are in an app the same way you share any other report or dashboard:

  • Open the report or dashboard, and select Share.

    Screenshot of the Share button on the ribbon.

See the article Share Power BI reports and dashboards with coworkers and others for more information.

Get an update of an app

Sometimes app designers release new versions of their apps. How you get the new version depends on how you received the original.

If you got the app from your organization, the update to the new version is automatic and you don't have to do anything.

If you got a template app from AppSource, the next time you open the app, you see a notification banner. The notification lets you know that a new version is available. To install the update, follow these steps:

  1. Select Get it to update.

  2. When prompted to install the updated app, select Install.

    Screenshot of the dialog to install and update an app.

  3. Because you already have a version of this app, you can decide whether you want to replace the existing version, update only the workspace content without updating the app, or install the updated app in a new workspace.

    Screenshot of the Update app dialog with the option called update the workspace and the app selected.

    Note

    Installing a new version overwrites any changes you might have made to the app's reports and dashboards. To keep your updated reports and dashboards, save them under a different name or in a different location before installing.

  4. Once you've installed the updated version, select Update app to complete the update process.

Considerations and troubleshooting

  • The ability to install apps can be turned on and off by your Power BI administrator. Contact your IT department or help desk if you need this feature enabled.
  • The use of apps requires either a Pro or Premium Per User license or for the app to be stored in a workspace in Premium shared capacity. Learn about licenses.
  • Some product surfaces might still use app, Power BI app, or similar older terminology for a workspace app while terminology updates are progressively applied.