Workspaces & Roles
Power BI · Power BI Service
Theory
A workspace is a shared container in the Service for related content: semantic models, reports, dashboards, dataflows and more. Each workspace has members with one of four roles. Viewer can view and interact with content but not change it. Contributor can also create, edit, publish and delete content in the workspace. Member can do everything a Contributor can, plus add people with Member or lower roles, share items and publish or update the workspace app. Admin has full control, including adding other Admins, changing settings and deleting the workspace.
For example, a Sales Analytics workspace might give the BI team Member or Contributor, its lead Admin, and a few reviewers Viewer. Most report readers should not be workspace members at all; they should get the content through an app. My workspace is a personal area for your own experiments and is not meant for sharing.
Why we use it
Roles control who can change versus only read content. Getting them right prevents accidental edits or deletions and keeps production reports reliable.
When to use it
Create workspaces per team, subject or environment (Dev, Test, Prod). Give creators Contributor or Member, keep Admin to a few owners, and distribute to large audiences through apps instead of adding everyone as Viewer.
How it works
- Person needs access to content
- Will they create or edit content? Yes: Give Contributor (or Member if they manage the app). No: Continue.
- Are they one of many readers? Yes: Distribute through an app. No: Give Viewer in the workspace.
- Prefer security groups over individuals
- Access matches responsibility
Syntax
Service → Workspaces → New workspace
Workspace → Manage access → Add people or groups → role: Admin | Member | Contributor | Viewer
Tip: assign security groups rather than individualsExample
Setting up 'Sales Analytics':
1. Workspaces → New workspace → name 'Sales Analytics'.
2. Manage access: BI-Leads group → Admin; BI-Developers group → Contributor.
3. Priya (reviewer) → Viewer.
4. Regional managers are not added here; they receive the 'Sales' app.
5. A separate 'Sales Analytics [Dev]' workspace is used for testing changes.Key points
- Four roles: Admin, Member, Contributor, Viewer
- Viewer: read and interact only
- Contributor: create, edit and publish content
- Member: also share, add users and publish the app
- Use apps for large reader audiences, not workspace roles