Create the new workspaces in Power BI

This article explains how to create one of the new workspaces instead of a classic workspace. Both kinds of workspaces are places to collaborate with colleagues. In them, you create collections of dashboards, reports, and paginated reports. If you want, you can also bundle that collection into an app and distribute it to a broader audience.

Here's how the new workspaces differ from the old. In the new workspaces, you can:

  • Assign workspace roles to user groups and individuals.
  • Create a workspace in Power BI without creating a Microsoft 365 group.
  • Use more granular workspace roles for more flexible permissions management.

Sales & Marketing sample workspace

For more background, see the new workspaces article.

Ready to migrate your classic workspace? See Upgrade classic workspaces to the new workspaces in Power BI for details.


To enforce row-level security (RLS) for Power BI Pro users browsing content in a workspace, assign the users the Viewer Role.

Create one of the new workspaces

  1. Start by creating the workspace. Select Workspaces > Create workspace.

    Create workspace

  2. You're automatically creating an upgraded workspace, unless you opt to Revert to classic.

    New workspace experience

    If you select Revert to classic, you create a classic workspace based on a Microsoft 365 group.

  3. Give the workspace a unique name. If the name isn't available, edit it to come up with a unique name.

    The app you create from the workspace will have the same name and icon as the workspace.

  4. Here are some optional items you can set for your workspace:

    Upload a Workspace image. Files can be .png or .jpg format. File size has to be less than 45 KB.

    Add a Contact list. By default, the workspace admins are the contacts.

    Specify a Workspace OneDrive to use a Microsoft 365 group file storage location.

    To assign the workspace to a Dedicated capacity, on the Premium tab select Dedicated capacity.

    Dedicated capacity

  5. Select Save.

    Power BI creates the workspace and opens it. You see it in the list of workspaces you’re a member of.

Create a contact list

You can specify which users receive notification about issues occurring in the workspace. By default, any user or group specified as a workspace admin is notified, but you can add others to the contact list. Users or groups in the contact list are listed in the user interface (UI) to help users get help related to the workspace.

  1. Access the new Contact list setting in one of two ways:

    In the Create a workspace pane when you first create it.

    In the nav pane, select the arrow next to Workspaces, select More options (...) next to the workspace name > Workspace settings. The Settings pane opens.

    Workspace settings

  2. Under Advanced > Contact list, accept the default, Workspace admins, or add your own list of Specific users or groups.

    Workspace contacts

  3. Select Save.

Set a workspace OneDrive

The Workspace OneDrive feature allows you to configure a Microsoft 365 group whose SharePoint Document Library file storage is available to workspace users. You create the group outside of Power BI first.

Power BI doesn't synchronize permissions of users or groups who are configured to have workspace access with the Microsoft 365 group membership. The best practice is to give access to the workspace to the same Microsoft 365 group whose file storage you configure in this setting Microsoft 365 group. Then manage workspace access by managing membership of the Microsoft 365 group.

  1. Access the new Workspace OneDrive setting in one of two ways:

    In the Create a workspace pane when you first create it.

    In the nav pane, select the arrow next to Workspaces, select More options (...) next to the workspace name > Workspace settings. The Settings pane opens.

    Workspace settings

  2. Under Advanced > Workspace OneDrive, type the name of the Microsoft 365 group that you created earlier. Type just the name, not the URL. Power BI automatically picks up the OneDrive for the group.

    Specify a OneDrive location

  3. Select Save.

Access the workspace OneDrive location

After you've configured the OneDrive location, you get to it in the same way you get to other data sources in the Power BI service.

  1. In the nav pane, select Get Data, then in the Files box select Get.

    Get data, get files

  2. The OneDrive – Business entry is your own OneDrive for Business. The second OneDrive is the one you added.

    Workspace files location - get data

Connect to apps in new workspaces

The new workspace experiences create and consume apps instead of content packs. Apps are collections of dashboards, reports, and datasets that connect to third-party services and organizational data. Apps make it easy to get data from the services such as Microsoft Dynamics CRM, Salesforce, and Google Analytics.

In the new workspace experience, you can't create or consume organizational content packs. Ask your internal teams to provide apps for any content packs you’re currently using.

Give access to your workspace

Anyone who has an admin role in a workspace can give others access to the workspace.

  1. Because you're an admin, on the workspace content list page, you see Access.

    Workspaces content list

  2. Add security groups, distribution lists, Microsoft 365 groups, or individuals to these workspaces as admins, members, contributors, or viewers. See Roles in the new workspaces for an explanation of the different roles.

    Workspaces add members, admins, contributors

  3. Select Add > Close.

Distribute an app

If you want to distribute official content to a large audience in your organization, you can publish an app from your workspace. When the content is ready, you choose which dashboards and reports you want to publish, and publish it as an app. You can create one app from each workspace.

Read about how to publish an app from the new workspaces.

Security settings

The Allow contributors to update the app for this workspace setting allows workspace Admins to delegate to users in the Contributor role the ability to update the app for the workspace. By default, only workspace Admins and Members can publish and update the app for the workspace.

When enabled, Contributors can:

  • Update app metadata like name, icon, description, support site, and color
  • Add or remove items included in the app, like adding reports or datasets
  • Change the app navigation or default item the app opens on

However, Contributors are not able to:

  • Publish the app for the first time
  • Change who has permission to the app

Next steps