10.1 Workspaces, Apps, and Content Distribution

Key Takeaways

  • Workspaces are containers for reports, dashboards, semantic models, and dataflows — they control access and collaboration.
  • Apps bundle workspace content into a curated package for broad distribution to consumers who don't need workspace access.
  • Content can be distributed via workspace sharing, apps, embed codes, publish to web, or email subscriptions.
  • Dashboards are single-page canvases with pinned tiles from multiple reports — created only in the Power BI Service.
  • The 'Publish to web' option creates a public URL that anyone can access — use with extreme caution for sensitive data.
Last updated: March 2026

Workspaces, Apps, and Content Distribution

Quick Answer: Workspaces organize Power BI content (reports, datasets, dashboards) with access control. Apps package workspace content for easy consumption without giving workspace access. Dashboards pin tiles from multiple reports onto one page. Choose distribution method based on audience: apps for broad audiences, workspace sharing for collaborators, subscriptions for automated delivery.

Workspaces

What is a Workspace?

A workspace is a container in the Power BI Service that holds:

  • Reports (.pbix files)
  • Semantic models (datasets)
  • Dashboards
  • Dataflows
  • Paginated reports
  • Scorecards

Creating a Workspace

Power BI Service → Workspaces → Create a workspace
→ Enter name, description
→ Optional: Configure license mode, OneDrive connection

Workspace Roles

RolePermissions
AdminFull control: manage membership, delete workspace, publish apps
MemberCreate/edit/delete content, publish apps, share items
ContributorCreate/edit/delete content, but cannot publish apps or share
ViewerView and interact with content only (no editing)

Role assignment:

Workspace → Settings → Manage access → Add people/groups → Assign role

Workspace vs. My Workspace

FeatureMy WorkspaceShared Workspace
OwnershipPersonal (only you)Team/organizational
SharingLimitedFull collaboration
AppsCannot publishCan publish apps
LifecyclePersonal developmentProduction content

Best Practice: Use "My Workspace" for personal development and testing. Publish production content to shared workspaces.

Apps

What is an App?

An App bundles workspace content into a curated, read-only package for distribution:

  • Curated navigation — organize content in a custom structure
  • No workspace access needed — consumers see only the app, not the workspace
  • Broad distribution — push to the entire organization or specific groups
  • Updatable — update the app without republishing individual reports

Creating an App

Workspace → Create app
→ Configure: Name, description, logo, theme color
→ Content: Select which reports/dashboards to include
→ Navigation: Build custom navigation structure
→ Permissions: Choose who can install the app

App Updates

When workspace content changes:

Workspace → Update app → Review changes → Publish

App consumers see the updated content after you explicitly update the app.

App vs. Workspace Sharing

FeatureAppWorkspace Sharing
AudienceLarge/broadSmall/collaborative
AccessRead-onlyRole-based (view to admin)
NavigationCustom curatedDefault workspace list
Content selectionChoose what to includeAll workspace content
BrandingCustom logo, colorsStandard Power BI

Dashboards

What is a Dashboard?

A dashboard is a single-page canvas with pinned tiles from multiple reports and other sources.

Dashboard vs. Report

FeatureDashboardReport
PagesSingle page onlyMulti-page
CreationPower BI Service onlyPower BI Desktop or Service
Data sourcesTiles from multiple datasets/reportsSingle dataset per report
InteractivityClick tiles to navigate to source reportFull interactivity (slicers, filters)
AlertsSupports data alerts on tilesNo data alerts
Q&AIntegrated Q&A boxSeparate Q&A visual

Creating a Dashboard

  1. From a report: Open a report → hover over a visual → click the Pin icon → select destination dashboard
  2. From Q&A: Type a question on the dashboard → pin the resulting visual
  3. From Excel: Pin ranges from Excel Online
  4. Custom tiles: Add web content, images, text boxes, streaming data

Pinning Tiles

Open report → Hover over visual → Pin icon (📌)
→ Choose: Existing dashboard or New dashboard
→ Pin

Pin options:

  • Pin a specific visual from a report
  • Pin an entire report page as a live tile
  • Pin from a Q&A query

Content Distribution Methods

MethodAudienceUse Case
AppLarge groups, org-wideStandard business reports for consumers
Workspace sharingSmall teams, collaboratorsDevelopment, editing, co-authoring
Direct sharingSpecific individualsQuick ad-hoc sharing
Email subscriptionAutomated recipientsScheduled report delivery
EmbedExternal/custom appsEmbedded analytics in portals
Publish to webPublic internet⚠️ Public data only — no auth required

Email Subscriptions

Set up automated report delivery:

Report → Subscribe → Configure:
  - Recipients
  - Frequency (daily, weekly, monthly, after refresh)
  - Format (PDF attachment, link)
  - Page and filter selections

Data Alerts (Dashboard Only)

Configure alerts when data exceeds thresholds:

Dashboard tile → More options → Manage Alerts
→ Set condition: Above/Below threshold
→ Configure notification frequency

Gateways

A gateway bridges on-premises data sources with the Power BI Service:

When is a Gateway Required?

ScenarioGateway Needed?
Cloud data source (Azure SQL, SharePoint Online)No
On-premises SQL ServerYes
On-premises Excel/CSV filesYes
On-premises Oracle, SAPYes
Web API (public internet)No

Gateway Types

TypeDescription
On-premises data gateway (standard)Shared by multiple users, managed centrally by IT
On-premises data gateway (personal)Single user, installed on their machine

Scheduled Refresh with Gateway

After installing a gateway and configuring data source credentials:

Dataset Settings → Scheduled Refresh → Configure:
  - Frequency (daily/weekly)
  - Time(s) of day
  - Time zone
  - Failure notifications
  - Gateway connection

Promoting and Certifying Content

Endorsement Levels

LevelDescriptionWho Can Apply
PromotedContent is ready for broad useAny workspace member
CertifiedContent meets organizational quality standardsAuthorized certifiers only (admin-configured)
Dataset/Report Settings → Endorsement → Select level

Why it matters:

  • Certified content appears with a badge in search and browsing
  • Helps users find trusted, approved data sources
  • Reduces "shadow BI" — users connecting to unreliable data

On the Exam

The PL-300 frequently tests:

  • Understanding workspace roles and their permissions
  • Choosing between apps and workspace sharing for distribution
  • Knowing when a gateway is required (on-premises data)
  • Configuring scheduled refresh and understanding refresh limits
  • Promoting vs. certifying content
Test Your Knowledge

A department of 200 people needs read-only access to a set of Power BI reports. They should NOT be able to edit content or see the underlying workspace structure. What is the best distribution method?

A
B
C
D
Test Your Knowledge

A report uses data from an on-premises SQL Server. After publishing to the Power BI Service, scheduled refresh fails. What is the most likely issue?

A
B
C
D
Test Your Knowledge

What is the difference between "Promoted" and "Certified" endorsement in Power BI?

A
B
C
D