Power BI implementation planning: Workspace-level workspace planning


This article forms part of the Power BI implementation planning series of articles. This series focuses primarily on the Power BI workload within Microsoft Fabric. For an introduction to the series, see Power BI implementation planning.

This article covers Fabric workspace-level planning, with an emphasis on the Power BI experience. It's primarily targeted at:

  • Fabric administrators: The administrators who are responsible for overseeing Fabric in the organization.
  • Center of Excellence, IT, and BI team: The teams who are also responsible for overseeing data and BI and supporting self-service users throughout the organization.
  • Content creators and owners: Self-service creators who need to create, publish, and manage content in workspaces.

To use workspaces effectively, there are many tactical decisions to be made. Whenever possible, individual workspace-level decisions should align with your tenant-level decisions.


The concept of a workspace originated in Power BI. With Fabric, the purpose of a workspace has become broader. The result is that a workspace can now contain items from one or more different Fabric experiences (also known as workloads). Even though the content scope has become broader than Power BI, most of the workspace planning activities described in these articles can be applied to Fabric workspace planning.

Workspace purpose

When planning for workspaces, it's important to consider not only the type of content it will store, but also the activities that the workspace is intended to support.

Consider the following two examples of finance-related workspaces. Although they're both dedicated to the same team, each workspace serves a different purpose:

  • Financial month-end workspace: The Financial month-end workspace contains reconciliation and month-end closing reports. This workspace is considered an informal workspace to support collaborative efforts. A Power BI app isn't necessary for content viewers because the primary use of this workspace is collaboration by a small group of people who work closely together. Most team members have permission to edit content in this workspace.
  • Financial reporting workspace: The Financial reporting workspace contains the finalized, presentation-level reports. This workspace contains content that's broadly distributed throughout the organization to many viewers (including executives) by using a Power BI app. The workspace is closely governed.

With these two examples in mind, consider two specific aspects of workspace purpose: intent for collaboration, and intent for viewing.

Intent for collaboration

The primary objective of a workspace in the Fabric portal is to facilitate collaboration among multiple people. There are many ways that collaboration can happen in a workspace:

  • Team-based development: Multiple people can work together to build, test, and publish content. One user might work on the design of a lakehouse. Another user might work on the design of the semantic model (previously known as a dataset), while other users might focus on building reports.
  • Testing and validations: Users might need to perform data validations for new content. Subject matter experts from the business unit might need to perform user acceptance testing (UAT), or a data quality team might need to validate the accuracy of the semantic model.
  • Enhancements: Stakeholders and consumers of the content might suggest enhancements to the content as circumstances change.
  • Ownership transfer: Another person or team might take over responsibility for content that was created by someone else.

One of the key areas of the Fabric adoption roadmap is content ownership and management. The type of collaboration that will occur in a workspace will differ based on the approach used for content ownership and management:

  • Business-led self-service BI: Content is owned and managed by the content creators within a business unit or department. In this scenario, most collaboration in the workspace occurs among users within that business unit.
  • Managed self-service BI: Data is owned and managed by a centralized team, whereas various content creators from business units take responsibility for reports and dashboards. In this scenario, it's highly likely that multiple workspaces will be needed to securely facilitate collaboration by multiple teams of people.
  • Enterprise BI: Content is owned and managed by a centralized team, such as IT, enterprise BI, or the Center of Excellence (COE). In this scenario, collaboration efforts in the workspace are occurring among users in the centralized team.

Checklist - When considering your intentions for collaboration in a workspace, key decisions and actions include:

  • Consider expectations for collaboration: Determine how workspace collaboration needs to occur and who's involved within a single team or across organizational boundaries.
  • Consider expectations for content ownership and management: Think about how the different content ownership and management approaches (business-led self-service BI, managed self-service BI, and enterprise BI) will influence how you design and use workspaces.


When your needs can't be met by a single approach, be prepared to be flexible and use a different content ownership and management strategy for different workspaces. The strategy can be based on the scenario as well as the team members that are involved.

Intent for content viewing

The secondary objective for a workspace is to distribute content to consumers who need to view the content. For content viewers, the primary Fabric workload is Power BI.

There are several different ways to approach content distribution in the Power BI service:

  • Reports can be viewed by using a Power BI app: Content stored in a non-personal workspace can be published to a Power BI app. A Power BI app is a more user-friendly experience than viewing reports directly in a workspace. For this reason, using a Power BI app is often the best choice for distributing content to consumers. Audiences for a Power BI app are very flexible. However, sometimes the goals for how you want to distribute content with an app are a factor in determining how to organize content in or across workspaces. For more information about securing Power BI apps, see Report consumer security planning.
  • Reports can be viewed directly in the workspace: This approach is often appropriate for informal, collaborative workspaces. Workspace roles define who can view or edit the content contained in a workspace. For more information about workspace roles, see Content creator security planning.
  • Reports can be shared: Use of per-item permissions (links or direct access) is useful when there's a need to provide read-only access to a single item within a workspace. We recommend that you use app permissions and workspace roles more frequently than sharing because they're easier to maintain. For more information, see Report consumer security planning.
  • Reports can be embedded in another application and viewed there: Sometimes the intention is for consumers to view Power BI content that's embedded in another application. Embedding content is useful when it makes sense for the user to remain in the application to increase efficiency and stay within its workflow.

Another key area of the Fabric adoption roadmap is content delivery scope. The ways that a workspace will support content distribution will differ based on the content delivery scope:

  • Personal BI: Content is intended for use by the creator. Since sharing content with others isn't an objective, personal BI is done within a personal workspace (described in the next topic).
  • Team BI: Content is shared with a relatively small number of colleagues who work closely together. In this scenario, most workspaces are informal, collaborative workspaces.
  • Departmental BI: Content is distributed to many consumers who belong to a large department or business unit. In this scenario, the workspace is primarily for collaboration efforts. In departmental BI scenarios, content is commonly viewed in a Power BI app (instead of directly viewed in the workspace).
  • Enterprise BI: Content is delivered broadly across organizational boundaries to the largest number of target consumers. In this scenario, the workspace is primarily for collaboration efforts. For enterprise BI scenarios, content is commonly viewed in a Power BI app (instead of directly viewed in the workspace).


When you plan your workspaces, consider the needs of the audience when determining the workspace license mode. The type of license that's assigned to the workspace will impact the features that are available, including who can view or manage workspace content.

Checklist - When considering your expectations for how workspace content will be viewed, key decisions and actions include:

  • Consider expectations for viewing content: Determine how you expect consumers to view content that's been published to the workspace. Consider whether viewing will happen directly in the workspace directly or by using a different method.
  • Determine who the content will be delivered to: Consider who the target audience is. Also consider the workspace license mode, especially when you expect a significant number of content viewers.
  • Evaluate needs for a Power BI app: Consider what the workspace purpose is as it relates to the content distribution requirements. When a Power BI app is required, it can influence decisions about creating a workspace.
  • Consider expectations for content delivery scope: Consider how the different content delivery scopes (personal BI, team BI, departmental BI, and enterprise BI) will influence how you design and use workspaces.


Be prepared to be flexible. You can use a different content viewing strategy for workspaces based on the scenario as well as the team members that are involved. Also, don't be afraid to use different content delivery scope approaches for workspaces when it can be justified.

Appropriate use of personal workspaces

There are two types of workspaces:

  • Personal workspaces: Every user has a personal workspace. A personal workspace can be used for publishing certain types of content to the Fabric portal. Its primary purpose is to support personal BI usage scenarios.
  • Workspaces: The primary purpose of a workspace is to support collaboration among multiple users. Secondarily, a workspace can also be used for viewing content.

Using a personal workspace for anything other than learning personal BI, temporary content, or testing purposes can be risky because content in a personal workspace is managed and maintained by one person. Further, a personal workspace doesn't support collaboration with others.

To allow the creation of any type of Fabric item (like a lakehouse or warehouse), a workspace must be added to a Fabric capacity. That's true for both standard workspaces as well as personal workspaces. Therefore, you can govern who's able to create certain types of items within a personal workspace by way of its capacity assignment.

A personal workspace is limited in its options to share content with others. You can't publish a Power BI app from a personal workspace (and Power BI apps are an important mechanism for distributing content to the organization). Per-item permissions (links or direct access) are the only way to share personal workspace content with others. Therefore, extensive use of per-item permissions involves more effort and increases the risk of error. For more information, see Report consumer security planning.

Checklist - When considering your expectations for how personal workspaces should be used, key decisions and actions include:

  • Understand current use of personal workspaces: Have conversations with your users and review the activity activity data to ensure you understand what users are doing with their personal workspaces.
  • Decide how personal workspaces should be used: Decide how personal workspaces should (and should not) be used in your organization. Focus on balancing risk and ease of use with needs for content collaboration and viewing.
  • Relocate personal workspace content when appropriate: For critical content, move content from personal workspaces to standard workspaces when appropriate.
  • Create and publish documentation about personal workspaces: Create useful documentation or FAQs for your users about how to effectively use personal workspaces. Make the information available in your centralized portal and training materials.


For more information, see these Fabric adoption roadmap topics: centralized portal, training, and documentation.

Workspace ownership

One of the most important things to consider when planning workspaces is determining the ownership and stewardship roles and responsibilities. The goal is to have clarity on exactly who is accountable for creating, maintaining, publishing, securing, and supporting the content in each workspace.

Clarity on ownership is particularly relevant when responsibilities for creating and managing data are decentralized—or distributed—among departments and business units. This concept is also sometimes referred to as a data mesh architecture. For more information about data mesh, see What is data mesh?.

In Fabric, decentralized or distributed ownership is enabled through workspaces. Different areas of the organization can work independently, while still contributing to the same underlying data structure in OneLake. Each workspace can have its own administrator, access control, and capacity assignment (for billing, geographic data location, and performance monitoring).


An additional way to support workspace ownership in Fabric is with domains, which are described later in this article.

When the intent for collaboration involves decentralization and multiple teams beyond a single business unit, it can add complexity for managing workspaces. Often, it's helpful to create separate workspaces to clearly delineate which team is responsible for which content. Use of multiple workspaces allows you to be specific as to ownership and management responsibilities, and it can help you to set security according to the principle of least privilege. For more security considerations, see Content creator security planning.


Your decisions related to accountability and responsibility should correlate directly with your actions related to defining workspace access, which is described later in this article.

Checklist - When considering workspace ownership responsibilities, key decisions and actions include:

  • Gain a full understanding of how content ownership works: Ensure that you deeply understand how content ownership and management is happening throughout the organization. Recognize that there likely won't be a one-size-fits-all approach to apply uniformly across the entire organization. Understand decentralized or distributed ownership needs.
  • Define and document roles and responsibilities: Ensure that you define and document clear roles and responsibilities for people who collaborate in workspaces. Make this information available in onboarding activities, training materials, and your centralized portal.
  • Create a responsibility matrix: Map out who is expected to handle each function when creating, maintaining, publishing, securing, and supporting content. Have this information ready when you start planning for workspace access roles.
  • Consider co-ownership or multi-team ownership scenarios: Identify when a scenario exists where it would be helpful to separate out workspaces so that responsibilities are clear.
  • Create workspace management documentation: Educate workspace administrators and members about how to manage workspace settings and access. Include responsibilities for workspace administrators, members, and contributors. Make the information available in your centralized portal and training materials.

Workspace organization

How to organize workspaces is one of the most important aspects of workspace planning.

Different business units and departments might use workspaces slightly differently depending on their collaboration requirements. When you need a new workspace, we recommend that you consider the factors described in this section.

Workspace subject and scope

The following options present some suggestions about how you can organize workspaces by subject and scope.

In some cases, you might already have some useful groups established in Microsoft Entra ID (previously known as Azure Active Directory). You can then use them to manage access to resources for the defined subject area and scope. However, you might need to create some new groups to suit this purpose. See the workspace access section below for considerations.

Option 1: Workspace per subject area or project

Creating a workspace for each subject area or project allows you to focus on its purpose. It allows you to take a balanced approach.

Examples: Quarterly Financials or Product Launch Analysis

The advantages of option 1 include:

  • Managing user access for who is allowed to edit or view content is more straightforward since it's scoped per subject area.
  • When content will be accessed by users across organizational boundaries, structuring workspaces by subject area is more flexible and easier to manage (compared to option 2 discussed next).
  • Using a scope per subject area is a good compromise between workspaces that contain too many items and workspaces that contain too few items.

A disadvantage of option 1 is that depending on how narrow or wide workspaces are defined, there's still some risk that many workspaces will be created. Finding content can be challenging for users when content is spread across many workspaces.


When well-planned and managed, a workspace per subject area or project usually results in a manageable number of workspaces.

Option 2: Workspace per department or team

Creating a workspace per department or team (or business unit) is a common approach. In fact, alignment with the organizational chart is the most common way people start with workspace planning. However, it's not ideal for all scenarios.

Examples: Finance Department or Sales Team Analytics

The advantages of option 2 include:

  • Getting started with planning is simple. All content needed by the people that work in that department will reside in one workspace.
  • It's easy for users to know which workspace to use since all of their content is published to the workspace associated with their department or team.
  • Managing security roles can be straightforward, especially when Microsoft Entra groups are assigned to workspace roles (which is a best practice).

The disadvantages of option 2 include:

  • The result is often a broad-scoped workspace that contains many items. A broadly defined workspace scope can make it challenging for users to locate specific items.
  • Because there's a one-to-one relationship between a workspace and a Power BI app, a broadly defined workspace can result in apps for users that contain lots of content. This issue can be mitigated by excluding certain workspace items from the app, and with good design of the app navigation experience.
  • When users from other departments need to view specific workspace items, managing permissions can become more complex. There's a risk that people will assume that everything in the departmental workspace is for their eyes only. There's also a risk that the sharing of individual items will become overused in order to accomplish granular viewing permissions.
  • If some content creators need permission to edit some items (but not all items), it's not possible to set those permissions in a single workspace. That's because workspace roles, which determine edit or view permissions, are defined at the workspace level.
  • When you have a large number of workspace items, it often means you'll need to use strict naming conventions for items so that users are able to find what they need.
  • Broad workspaces with many items might run into a technical limitation on the number of items that can be stored in a workspace.


When creating workspaces that align with your organizational chart, you often end up with fewer workspaces. However, it can result in workspaces that contain a lot of content. We don't recommend aligning workspaces per department or team when you expect to have a significant number of items and/or many users.

Option 3: Workspace for a specific report or app

Creating a workspace for each report or type of analysis isn't recommended except for specific circumstances.

Examples: Daily Sales Summary or Executive Bonuses

Advantages of option 3 include:

  • The purpose of a narrowly defined workspace is clear.
  • Ultra-sensitive content can, and often should, be segregated into its own workspace so that it can be managed and governed explicitly.
  • Fine-grained workspace permissions are applicable to a few items. This setup is useful when, for instance, a user is permitted to edit one report but not another.

Disadvantages of option 3 include:

  • If overused, creating narrowly defined workspaces results in a large number of workspaces.
  • Having a large number of workspaces to work with involves more effort. While users can rely on search, finding the right content in the right workspace can be frustrating.
  • When a larger number of workspaces exist, there's more work from an auditing and monitoring perspective.


Creating a workspace with a narrow scope, such as an individual report, should be done for specific reasons only. It should be the exception rather than the rule. Occasionally, separating scorecards into their own workspace is a useful technique. For example, using a separate workspace is helpful when a scorecard presents goals that span multiple subject areas. It's also helpful to set up specific permissions for managing and viewing the scorecard.

Checklist - When considering the subject area and scope of workspace content, key decisions and actions include:

  • Assess how workspaces are currently set up: Review how people currently use workspaces. Identify what works well and what doesn't work well. Plan for potential changes and user education opportunities.
  • Consider the best workspace scope: Identify how you want people to use workspaces based on purpose, subject area, scope, and who's responsible for managing the content.
  • Identify where highly sensitive content resides: Determine when creating a specific workspace for highly sensitive content can be justified.
  • Create and publish documentation about using workspaces: Create useful documentation or FAQs for your users about how to organize and use workspaces. Make this information available in training materials and your centralized portal.

Workspace item types

Separating data workspaces from reporting workspaces is a common practice for decoupling data assets from analytical assets.

  • A data workspace is dedicated to storing and securing data items such as a lakehouse, warehouse, data pipeline, dataflow, or semantic model.
  • A reporting workspace is focused more on the downstream analytical activities. It's dedicated to storing and securing items such as reports, dashboards, and metrics. Reporting workspaces primarily (but not necessarily exclusively) include Power BI content.


Each Fabric experience allows you to create various types of items. These items don't always fit neatly into the concept of what's considered data versus reporting (or analytical) content. One example is a Fabric notebook that can be used in many different ways, such as: loading and transforming data in a lakehouse, submitting Spark SQL queries, or analyzing and visualizing data with PySpark. When the workspace will contain mixed workloads, we recommend that you focus primarily on the workspace purpose and ownership of the content as described elsewhere in this article.

The advantages for separating data workspaces from reporting workspaces include:

  • Critical organizational data, such as an endorsed lakehouse or semantic model, can reside in a specific workspace that's designed to make reusable data available at enterprise scale. Common examples include:
  • Access management can be centralized for critical organizational data. Managing access separately for the data workspace compared with reporting workspace(s) is useful when different people are responsible for data and reports. With managed self-service BI, it's common to have many report creators and fewer data creators.
  • Limiting who can edit and manage semantic models minimizes the risk of unintentional changes, especially to critical data items that are reused for many purposes or by many users. Physical separation reduces the chances of inadvertent, or unapproved, changes. This extra layer of protection is helpful for certified semantic models, which are relied upon for their quality and trustworthiness.
  • Co-ownership scenarios are clarified. When shared semantic models are delivered from a centralized BI or IT team, while reports are published by self-service content creators (in business units), it's a good practice to segregate the semantic models into a separate workspace. This approach avoids the ambiguity of co-ownership scenarios because ownership and responsibility per workspace is more clearly defined.
  • Row-level security (RLS) is enforced. When you encourage creators to work in different workspaces, they won't have unnecessary edit permission to the original semantic model. The advantage is that RLS and/or object-level security (OLS) will be enforced for content creators (and also content viewers).

The disadvantages for separating data workspaces from reporting workspaces include:

  • A workspace naming convention is required to be able to distinguish a data workspace from a reporting workspace.
  • Extra user education is required to ensure that content authors and consumers know where to publish and find content.
  • Sometimes it's challenging to clearly delineate the item types that should be contained within a workspace. Over time, a workspace can end up containing more types of content than was originally intended.
  • Use of separate workspaces results in a larger number of workspaces that you need to manage and audit. As you plan for purpose, scope, and other considerations (such as the separation of development, test, and production content) the approach to workspace design can become more complicated.
  • Extra change management processes could be required to track and prioritize requested changes to centralized data items, particularly when report creators have requirements beyond what can be handled by composite models and report-level measures.

Checklist - When considering the item types to store in a workspace, key decisions and actions include:

  • Determine your objectives for data reuse: Decide how to achieve data reuse as part of a managed self-service BI strategy.
  • Update the tenant setting for who can use semantic models across workspaces: Determine whether this capability can be granted to all users. If you decide to limit who can use semantic models across workspaces, consider using a group such as Fabric approved report creators.

Workspace access

Since the primary purpose of a workspace is collaboration, workspace access is mostly applicable to users who create and manage its content. It can also be relevant when the workspace is used for viewing content (a secondary purpose for workspaces, as described earlier in this article).

When starting to plan for workspace roles, it's helpful to ask yourself the following questions.

  • What are the expectations for how collaboration will occur in the workspace?
  • Will the workspace be used directly for viewing content by consumers?
  • Who will be responsible for managing the content in the workspace?
  • Who will view content that's stored in the workspace?
  • Is the intention to assign individual users or groups to workspace roles?

It's a best practice to use groups for assigning workspace roles whenever practical. There are different types of groups you can assign. Security groups, mail-enabled security groups, distribution groups, and Microsoft 365 groups are all supported for workspace roles. For more information about using groups, see Tenant-level security planning.

When planning to use groups, you might consider creating one group per role per workspace. For example, to support the Quarterly Financials workspace, you could create the following groups:

  • Fabric workspace admins – Quarterly Financials
  • Fabric workspace members – Quarterly Financials
  • Fabric workspace contributors – Quarterly Financials
  • Fabric workspace viewers – Quarterly Financials
  • Power BI app viewers – Quarterly Financials


Creating the groups listed above provides flexibility. However, it involves creating and managing many groups. Also, managing a large number of groups can be challenging when groups are only created and maintained by IT. This challenge can be mitigated by enabling self-service group management to certain satellite members. These members can include the Center of Excellence (COE), champions, or trusted users who have been trained in how to manage role memberships for their business unit. For more information, see Tenant-level security planning.

When data workspaces are separated from reporting workspaces, as described earlier in this article, it results in an even larger number of groups. Consider how the number of groups doubles from five to 10 when you separate data and reporting workspaces:

  • Fabric data workspace admins – Quarterly Financials
  • Fabric reporting workspace admins – Quarterly Financials
  • Fabric data workspace members – Quarterly Financials
  • Fabric reporting workspace members – Quarterly Financials
  • Fabric data workspace contributors – Quarterly Financials
  • Fabric reporting workspace contributors – Quarterly Financials
  • Fabric data workspace viewers – Quarterly Financials
  • Fabric reporting workspace viewers – Quarterly Financials
  • Power BI app viewers – Quarterly Financials

When multiple workspaces exist for development, test, and production, it results in an even larger number of groups. There's the potential for the number of groups to triple. For example, for just the data workspace admins, there would be these three groups:

  • Fabric data workspace admins – Quarterly Financials [Dev]
  • Fabric data workspace admins – Quarterly Financials [Test]
  • Fabric data workspace admins – Quarterly Financials

The previous examples are intended to convey that the use of groups that map to workspace roles can quickly become unmanageable.


There are times when fewer groups are needed, particularly in development. For example, you might not need to specify a workspace viewers group in development; that group is only needed for testing and production. Or you might be able to use the same workspace admins group for development, test, and production. For more information about development, test, and production, see Workspace lifecycle management later in this article.

The effective use of groups for workspace roles can require considerable planning. Be prepared to encounter scenarios when existing groups (that might be aligned with the organizational chart) don't meet all your needs for managing Fabric content. In this case, we recommend that you create groups specifically for this purpose. That's why the words Fabric or Power BI are included in the group name examples shown above. If you have multiple business intelligence tools, you can choose to use only BI as the prefix instead. That way, you can use the same groups across multiple tools.

Lastly, the examples show one workspace - Quarterly Financials - but often it's possible to manage a collection of workspaces with one set of groups. For example, multiple workspaces owned and managed by the finance team might be able to use the same groups.


You'll often plan security more broadly, taking into consideration semantic model Read and Build permission requirements, and row-level security (RLS) requirements. For more information about what to consider for supporting report consumers and content creators, see the security planning articles. For the purposes of this article, the focus is only on workspace roles as part of the workspace planning process.

Checklist - When considering workspace access, key decisions and actions include:

  • Refer to roles and responsibilities: Use the roles and responsibilities information prepared earlier to plan for workspace roles.
  • Identify who'll own and manage the content: Verify that all the items you expect to store in a single workspace align with the people who'll take responsibility for owning and managing the content. If there are mismatches, reconsider how the workspaces could be better organized.
  • Identify who'll view content in the workspace: Determine whether people will view content directly from the workspace.
  • Plan for the workspace roles: Determine which people are suited to the Admin, Member, Contributor, and Viewer roles for each workspace.
  • Decide on group or individual role assignments: Determine whether you intend to assign individual users or groups to workspace roles. Check whether there are existing groups that you can use for workspace role assignments.
  • Determine whether new groups need to be created: Consider carefully whether you need to create a new group per workspace role. Bear in mind that it can result in creating and maintaining many groups. Determine what the process is when a new workspace is created and how related groups will be created.
  • Configure and test the workspace role assignments: Verify that users have the appropriate security settings they need to be productive while creating, editing and viewing content.

Workspace domain

As described earlier in this article, it's critical to have clarity on workspace ownership. One way to further support workspace ownership in Fabric is with domains. A domain is a way to logically group multiple workspaces that have similar characteristics.

For more information about planning for domains in your tenant, see Workspace domains.

Workspace settings

There are several settings you can set up for each individual workspace. These settings can significantly influence how collaboration occurs, who is allowed to access the workspace, and the level of data reusability across Fabric workloads.

Workspace license mode

Each workspace has a license mode setting. It can be set to Pro, Premium per user (PPU), Fabric capacity, Embedded, or Trial. The type of license is important for workspace planning because it determines:

  • Features: Different features are supported. PPU includes more features (such as deployment pipelines) that aren't available in Pro. Many more Fabric features (such as lakehouses) become available for workspaces assigned to a Fabric capacity.
  • Content access: The license type determines who can access content in the workspace:
    • Only users who have a PPU license (in addition to being assigned a workspace role) can access a PPU workspace.
    • If you expect to deliver content to content viewers who have a free license, you'll need a license of F64 or higher.
  • Data storage location: When you need to store data in a specific geographic region (outside of your home region), that becomes possible with a workspace assigned to a capacity (and, accordingly, the capacity is created in that region). For more information about data storage location, see Tenant setup.

Checklist - When considering the workspace license mode, key decisions and actions include:

  • Consider which features are required for each workspace: Determine the feature requirements of each workspace. Consider differences in workload and which users you intend to access the workspace.
  • Set the workspace license mode: Review and update each workspace license mode according to which features are needed by each workspace.

Workspace lifecycle management

When content creators collaborate to deliver analytical solutions that are important to the organization, there are various lifecycle management considerations. These processes are also known as continuous integration/continuous delivery (CI/CD), which are one aspect of DevOps.

Several lifecycle management considerations include:

  • How to ensure timely, reliable, and consistent delivery of content.
  • How to communicate and coordinate activities between multiple content creators who are working on the same project.
  • How to resolve conflicts when multiple content creators edit the same item in the same project.
  • How to structure a straightforward and reliable deployment process.
  • How to roll back deployed content to a previous stable, working version.
  • How to balance fast releases of new features and bug fixes while safeguarding production content.

In Fabric, there are two main components of lifecycle management.

  • Version control of content: Git integration allows content owners and creators to create versions of their work. It can be used with web-based development in a workspace, or when developing in a client tool, such as Power BI Desktop. Version control (also known as source control) is achieved by tracking all revisions to a project by using branches associated with local and remote repositories in Azure DevOps. Changes are committed at regular intervals to branches in the remote repository. When a content creator has completed revisions that are tested and approved, their branch is merged with the latest version of the solution in the main remote repository (after resolving any merge conflicts). Git integration can be specified for each workspace in the Fabric portal, providing the feature has been enabled in the tenant settings.
  • Promoting content: Deployment pipelines are primarily focused on release management in order to maintain a stable environment for users. You can assign a workspace to a stage (development, test, or production) in a deployment pipeline. Then, you can easily and systematically promote, or deploy, your content to the next stage.

When combining the lifecycle management features, there are best practices to consider during your planning process. For example, you might choose to use Git integration for your development workspace and deployment pipelines to publish to your test and production workspaces. Those types of decisions require using the agreed-upon practice consistently. We recommend that you do a proof of concept to fully test your setup, processes, and permissions model.

Checklist - When planning for workspace lifecycle management, the key decisions and actions include:

  • Determine how users need to use version control: Analyze how your self-service and advanced content creators work to determine whether file versioning with OneDrive for Business or SharePoint is appropriate. Introduce Git integration for advanced users who need more capabilities. Prepare to support both types of users.
  • Determine how users need to promote content: Analyze how your self-service and advanced content creators work to determine whether deployment pipelines are a good fit for promoting content.
  • Decide whether Git integration should be enabled: Consider whether Git integration with workspaces is a good fit for how your content creators work. Set the Users can synchronize workspace items with their Git repositories tenant setting to align with this decision. Review each of the Git integration tenant settings and set them according to your governance guidelines.
  • Do a proof of concept: Conduct a technical proof of concept to clarify how you intend for Git workspaces and deployment pipelines to work together.
  • Decide which workspaces should have Git integration: Consider how your content creators work, and which workspaces should be assigned to a development, test, or production (release) branch.
  • Verify licenses: Confirm that you have a capacity license available to use Git integration. Ensure that each workspace is assigned to a Fabric capacity or Power BI Premium capacity.
  • Set up Azure DevOps: Work with your administrator to set up the Azure DevOps projects, repositories, and branches that you'll need for each workspace. Assign appropriate access to each repository.
  • Connect workspaces: Connect each workspace to the appropriate Azure DevOps repository.
  • Consider who should deploy to production: Make decisions on how and who should be able to update production content. Ensure that these decisions align with how workspace ownership is handled in your organization.
  • Educate content creators: Ensure that all your content creators understand when to use lifecycle management features and practices. Educate them on the workflow and how different workspaces impact lifecycle management processes.

Workspace integration with ADLS Gen2

It's possible to connect a workspace to an Azure Data Lake Storage Gen2 (ADLS Gen2) account. There are two reasons you might do that:

  • Storage of Power BI dataflows data: If you choose to bring-your-own-data-lake, the data for Power BI dataflows (Gen1) could be accessed directly in Azure. Direct access to dataflow storage in ADLS Gen2 is helpful when you want other users or processes to view or access the data. It's especially helpful when your goal is to reuse dataflows data beyond Power BI. There are two choices for assigning storage:
    • Tenant-level storage, which is helpful when centralizing all data for Power BI dataflows into one ADLS Gen2 account is desired.
    • Workspace-level storage, which is helpful when business units manage their own data lake or have certain data residency requirements.
  • Backup and restore for Power BI semantic models: The Power BI semantic model backup and restore feature is supported for workspaces that are assigned to capacity or PPU. This feature uses the same ADLS Gen2 account that's used for storing Power BI dataflows data (described in the previous bullet point). Semantic model backups are helpful for:
    • Complying with data retention requirements
    • Storing routine backups as part of a disaster recovery strategy
    • Storing backups in another region
    • Migrating a data model


Setting Azure connections in the Fabric admin portal doesn't mean that all dataflows for the entire tenant are stored by default to an ADLS Gen2 account. To use an explicit storage account (instead of internal storage), each workspace must be explicitly connected. It's critical that you set the workspace Azure connections prior to creating any Power BI dataflows in the workspace.

Checklist - When considering workspace integration with ADLS Gen2, key decisions and actions include:

  • Decide whether the workspace will be used in ways that require Azure Storage: Consider whether a bring-your-own-data-lake scenario would be useful for the storage of dataflows and/or whether you have requirements to use the semantic model backup and restore functionality.
  • Determine which Azure Storage account will be used: Select an Azure Storage account that has the hierarchical namespace enabled (ADLS Gen2) for tenant-level (centralized) storage of dataflows data or semantic model backups. Ensure you have the Azure Storage account information readily available.
  • Configure the tenant-level storage account: In the Fabric admin portal, set the tenant-level ADLS Gen2 storage account.
  • Decide whether workspace administrators can connect a storage account: Have discussions to understand the needs of decentralized teams, and whether individual teams are currently maintaining their own Azure Storage accounts. Decide whether this capability should be enabled.
  • Configure the admin setting for workspace-level storage: In the Fabric admin portal, enable the option that allows workspace administrators to connect their own storage account.
  • Set the workspace-level Azure Storage connections: Specify the Azure Storage account for each individual workspace. You must set the storage account prior to creating any Power BI dataflows in the workspace. If you intend to use semantic model backups, ensure the workspace license mode is set to capacity or PPU.
  • Update your workspace management documentation: Ensure that your workspace management documentation includes information about how to assign ADLS Gen2 storage accounts correctly. Make the information available in your centralized portal and training materials.

Workspace integration with Azure Log Analytics

Azure Log Analytics is a service within Azure Monitor. You can use Azure Log Analytics to review diagnostic data generated by the Analysis Services engine, which hosts Power BI semantic models. Workspace-level logs are useful for analyzing performance and trends, performing data refresh analysis, analyzing XMLA endpoint operations, and more. Azure Log Analytics is available only for workspaces assigned to capacity or PPU.


Although the names are similar, the data sent to Azure Log Analytics is different from the data captured by the Power BI activity log. The data sent to Azure Log Analytics is concerned with events generated by the Analysis Services engine (for example, Query begin and Query end events). Conversely, the activity log is concerned with tracking user activities (for example, View report or Edit report events).

For more information about semantic model event logs, see Data-level auditing.

For more information about how to set up Azure Log Analytics for use with Power BI, see Configuring Azure Log Analytics for Power BI. Be sure to understand the prerequisites you must have in place to make the integration work.

Checklist - When considering workspace integration with Azure Log Analytics, key decisions and actions include:

  • Decide whether workspace administrators can connect to Log Analytics: Determine whether all, or some, workspace administrators will be permitted to use Azure Log Analytics for analyzing workspace-level logs. If access is to be restricted to only certain people, decide which group to use.
  • Set up the tenant setting for Log Analytics connections: In the Fabric admin portal, set the tenant setting according to the decision for which workspace administrators set connections.
  • Set the Log Analytics workspace for each workspace: In the workspace settings, specify the Azure Log Analytics information for each workspace. To capture workspace-level logs, ensure that the workspace license mode is set to capacity or PPU.
  • Update your workspace management documentation: Ensure that your workspace management documentation includes information about how to assign a workspace to Azure Log Analytics.

Other workspace properties

There are several other workspace properties that can provide helpful information. For governed workspaces, we recommend that you set these properties.

Here are some suggestions for how to set these key settings to improve the experience for your users.

  • Workspace description: A good workspace description includes a brief, yet specific, explanation of what type of content can be found in the workspace. You can use up to 4000 characters to describe:
    • The purpose for the workspace
    • The target audience
    • The type of content published to the workspace
    • Whether the workspace is considered governed
    • Whether the workspace includes development, test, or production data
    • Who to contact should there be any questions (occasionally it's crucial to display this information as prominently as possible, in addition to the contact list that's described next)
  • Workspace contacts: The workspace contact list includes the workspace administrators by default. If you have technical content owners that are different from the subject matter experts, you might find it helpful to specify other contacts. Other contacts could be groups or individuals who can answer questions about the workspace content.
  • Workspace image: Consistent use of workspace images can be helpful for users when they're scanning a list of workspaces. Consider using an image to help users determine:
    • The domain or subject area
    • Which business unit or team owns and manages the content
    • Whether it's a data workspace (one that's dedicated to storing reusable items, such as a lakehouse, warehouse, data pipeline, dataflow, or semantic model)
    • Whether it's a reporting workspace (one that's dedicated to storing analytical items, such as reports, dashboards, or metrics)
  • Data model settings: Allows workspace members, administrators, and users with Build permission on the semantic model(s) to edit Power BI data models by using the web interface. This setting is used together with the Users can edit data models in the Power BI service tenant setting. This setting should align with your decisions and processes for how content is created, managed, and deployed. Also, consider your method for version control as described earlier in this article.

Checklist - When considering the other workspace properties, the key decisions and actions include:

  • Specify the workspace description: Ensure that there's a helpful and thorough description included in the workspace description.
  • Use a helpful image for the workspace: Set a consistent image for the workspace that'll visually help users understand its subject area, who owns and manages content in the workspace, and/or the type of content stored in the workspace.
  • Identify contacts for the workspace: Verify whether the workspace administrators should be the workspace contacts, or whether specific users or groups should be specified.
  • Specify data model settings: Consider which workspaces can permit web-based data model editing. Set the Users can edit data models in the Power BI service tenant setting according to your preferences for who can edit and manage content.

Other technical factors

There are other technical factors that might influence your workspace setup.

  • If you integrate content with other tools and services, there could be licensing implications. For example, if you embed a Power Apps visual in a Power BI report, you'll need appropriate Power Apps licenses.
  • There are per-workspace storage limits that apply to the amount of data you can store in a Pro workspace. If using capacity or PPU isn't an option, consider how to work within the storage limits during the workspace planning process.
  • When you install a template app from AppSource, it will create a new workspace that will have a narrow subject and scope.

Checklist - When considering other technical factors, key decisions and actions include:

  • Pay attention to technical factors: As you work through the planning process, determine whether there's a technical reason (such as per-workspace storage limits) that could influence your decision-making process.
  • Reorganize workspace content: If storage limits could become a problem, create separate workspaces now and republish content to these new workspaces.

Next steps

For more considerations, actions, decision-making criteria, and recommendations to help you with Power BI implementation decisions, see Power BI implementation planning.