# Power BI Workspace Checklist

> Publish content to cloud workspaces on the service for collaboration and distribution. Workspace set-up is one of the most important aspects of governing & planning your Power BI implementation.

- URL: https://data-goblins.com/workspace-checklist
- Author: Kurt Buhler
- Published: 2023-12-14
- Topic: Admin and governance

# WORKSPACES

*Publish content to cloud workspaces on the service for collaboration and distribution. Workspace set-up is one of the most important aspects of governing & planning your Power BI implementation.*

---

[BACK TO OTHER CHECKLISTS](/checklists)

---

## DATA GOBLINS POWER BI WORKSPACE CHECKLIST

**Version X.X - Update-in-progress: March 2024**

If you are setting up a Workspace for the first time, or auditing an existing Workspace, the below checklist helps you figure out what to pay attention to:

**Click the question mark (?) for a link to a reference document.** This will be learn.microsoft.com documentation; if none are available, this may be a Data Goblins article, or another blog post reference.

### Planning

Workspace planning & decision-making; this is always done.

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-planning-0" class="checklist-checkbox">
Clarify the purpose & usage scenario of the workspace; how will it be used? <a href="https://learn.microsoft.com/en-us/power-bi/guidance/powerbi-implementation-planning-workspaces-workspace-level-planning#workspace-purpose" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-planning-1" class="checklist-checkbox">
Decide the Workspace license mode (Premium, Pro, PPU) <a href="https://learn.microsoft.com/en-us/power-bi/guidance/powerbi-implementation-planning-workspaces-workspace-level-planning#workspace-license-type" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-planning-2" class="checklist-checkbox">
Plan content organization in the workspace (type, scope, environment...) <a href="https://learn.microsoft.com/en-us/power-bi/guidance/powerbi-implementation-planning-workspaces-workspace-level-planning#workspace-organization" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-planning-3" class="checklist-checkbox">
Identify whether Workspace staging is required (Development, QA, Production...) <a href="https://learn.microsoft.com/en-us/power-bi/guidance/powerbi-implementation-planning-usage-scenario-self-service-content-publishing" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-planning-4" class="checklist-checkbox">
Identify whether the Workspace will belong in a Deployment Pipeline or not <a href="https://learn.microsoft.com/en-us/power-bi/create-reports/deployment-pipelines-assign" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-planning-5" class="checklist-checkbox">
Decide how content will be used & distributed from the Workspace (i.e. App? Embedded?) <a href="https://learn.microsoft.com/en-us/power-bi/guidance/powerbi-implementation-planning-workspaces-workspace-level-planning#intent-for-content-viewing" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-planning-6" class="checklist-checkbox">
Identify related workspaces using content from this one with cross-workspace publishing <a href="https://learn.microsoft.com/en-us/power-bi/connect-data/service-datasets-across-workspaces" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-planning-7" class="checklist-checkbox">
Define if & how content in this workspace will be endorsed <a href="https://learn.microsoft.com/en-us/power-bi/collaborate-share/service-endorse-content" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-planning-8" class="checklist-checkbox">
Define how content is added (Publish , Deploy from CI/CD, Add from Service...) <a href="#footnotes">[1]</a> <a href="https://learn.microsoft.com/en-us/power-bi/create-reports/desktop-upload-desktop-files" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

### Access

Planning access management for the Workspace; who gets what role and why? How is this managed?

This is always done.

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-access-0" class="checklist-checkbox">
Define who is the Workspace SPOC, and the admins, members & contributors <a href="https://learn.microsoft.com/en-us/power-bi/collaborate-share/service-roles-new-workspaces" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-access-1" class="checklist-checkbox">
Decide whether contributors should be able to update the Workspace app <a href="https://learn.microsoft.com/en-us/power-bi/collaborate-share/service-roles-new-workspaces#:~:text=Contributors%20can%20update%20the%20app%20that%27s%20associated%20with%20the%20workspace%2C%20if%20the%20workspace%20Admin%20delegates%20this%20permission%20to%20them.%20However%2C%20they%20can%27t%20publish%20a%20new%20app%20or%20change%20who%20has%20permission%20to%20edit%20it." target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-access-2" class="checklist-checkbox">
Define the Azure AD Groups used to manage access & if new ones are needed <a href="https://learn.microsoft.com/en-us/power-bi/guidance/powerbi-implementation-planning-workspaces-workspace-level-planning#workspace-access" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-access-3" class="checklist-checkbox">
Define how item build permissions will be granted & managed (i.e. item level or app audience level?) <a href="https://learn.microsoft.com/en-us/power-bi/guidance/powerbi-implementation-planning-workspaces-workspace-level-planning#workspace-access" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

### Workspace Integrations & Connections

What additional tools & technologies are needed to manage this Workspace and ensure compliance with organization policies? This is only done if deemed necessary.

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-workspace-integrations-connections-0" class="checklist-checkbox">
Assess whether sensitivity labels are needed for Workspace content or not <a href="https://learn.microsoft.com/en-us/power-bi/enterprise/service-security-sensitivity-label-overview" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-workspace-integrations-connections-1" class="checklist-checkbox">
Assess whether an Azure Data Lake Gen2 will be connected to the workspace (BYODL) <a href="https://learn.microsoft.com/en-us/power-bi/transform-model/dataflows/dataflows-azure-data-lake-storage-integration" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-workspace-integrations-connections-2" class="checklist-checkbox">
Assess whether Azure Log Analytics will be integrated with the Workspace <a href="https://learn.microsoft.com/en-us/power-bi/transform-model/log-analytics/desktop-log-analytics-overview" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-workspace-integrations-connections-3" class="checklist-checkbox">
Assess whether OneDrive or a Git Repo are used for Version Control of Workspace Content <a href="https://learn.microsoft.com/en-us/power-bi/create-reports/deployment-pipelines-best-practices#version-control-for-pbix-files" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-workspace-integrations-connections-4" class="checklist-checkbox">
Define whether Workspace content will be accessed via external tools with XMLA endpoints <a href="https://learn.microsoft.com/en-us/power-bi/enterprise/service-premium-connect-tools" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

## WORKSPACE END-USER TRAINING CHECKLIST

If the workspace is being used by business users to manage their own content, it's important to train them on best practices to promote enablement while mitigating governance risk.

### Train Workspace Business Users

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-train-workspace-business-users-0" class="checklist-checkbox">
How to add or publish content to a Workspace <a href="https://learn.microsoft.com/en-us/power-bi/consumer/end-user-workspaces" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-train-workspace-business-users-1" class="checklist-checkbox">
How to use OneDrive for Version Control <a href="https://learn.microsoft.com/en-us/power-bi/create-reports/deployment-pipelines-best-practices#version-control-for-pbix-files" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-train-workspace-business-users-2" class="checklist-checkbox">
When to safely share via the app, the workspace, or the specific item <a href="https://learn.microsoft.com/en-us/power-bi/guidance/powerbi-implementation-planning-workspaces-workspace-level-planning#intent-for-content-viewing" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-train-workspace-business-users-3" class="checklist-checkbox">
How to use the lineage view to see related content <a href="https://learn.microsoft.com/en-us/power-bi/collaborate-share/service-data-lineage#explore-lineage-view" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-train-workspace-business-users-4" class="checklist-checkbox">
How to see & manage Workspace content permissions <a href="https://learn.microsoft.com/en-us/power-bi/connect-data/service-datasets-manage-access-permissions" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-train-workspace-business-users-5" class="checklist-checkbox">
When & how to archive Workspace content to avoid it becoming bloated
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-train-workspace-business-users-6" class="checklist-checkbox">
How to troubleshoot issues with access or permissions <a href="https://learn.microsoft.com/en-us/power-bi/collaborate-share/service-troubleshoot-sharing" target="_blank" rel="noopener" aria-label="Reference">?</a>
</label>

## WORKSPACE DOCUMENTATION CHECKLIST

Documentation varies from project-to-project and team-to-team, but below are some things you can consider documenting for your Power BI Workspace.

### Workspace Documentation

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-workspace-documentation-0" class="checklist-checkbox">
Basic info: Name, ID (for API use), SPOC, License type, Scope, etc.
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-workspace-documentation-1" class="checklist-checkbox">
Purpose: Usage scenario & business question/problem that the Workspace content addresses
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-workspace-documentation-2" class="checklist-checkbox">
Related Workspaces (cross-workspace publishing or deployment pipelines)
</label>

<label class="checklist-item">
<input type="checkbox" id="workspace-checklist-workspace-documentation-3" class="checklist-checkbox">
Connected services (ADLS Gen2, Log Analytics, OneDrive...)
</label>

<h2 id="footnotes">FOOTNOTES</h2>

[1] You can add content to a workspace by:  
A. Publishing from Power BI Desktop  
B. Using the workspace UI "+ New > Upload a file..."  
C. Deployments with a Deployment Pipeline  
D. Deployments with the REST API.  
*For C & D - Note that content created in the Service cannot easily be downloaded.*
