The Power BI new workspace experience has been General Available since April 2019. It offers improved security management, more flexible workspace roles, and new capabilities like a contact list to help you support your teams. Using the new workspace experience also enables several major features like shared and certified datasets and large models, to name a few.
Today, we released the documentation for workspace upgrade. We have not yet released the feature, so hold tight its coming soon. We’ve published the documentation so you can prepare for the new capability and seek clarification of any questions you may have before the release.
How to prepare for the upgrade
Who can upgrade a workspace and how does it work?
Workspace admins will be able to upgrade workspaces they own. Power BI admins can see which workspaces are classic workspaces by using the workspaces list in the Power BI admin portal. They can then work with workspace admins to upgrade the desired workspaces.
Watch the video below to see the upgrade in action. Scroll forward to 17 minutes and 26 seconds to the workspace upgrade section.
What is the user experience after an upgrade?
For end users, the upgrade keeps things like they were before you upgraded the workspace. The URLs and item identifiers of the workspace, the items it contains, and the app you published from it don’t change. Features like data refresh, subscriptions, and so forth keep working as they did before the upgrade.
Additionally, upgrading your Power BI workspace doesn’t change or remove the Office 365 Group. Any of the Teams, SharePoint Sites, OneNote notebooks, or other things tied to the Office 365 Groups continue to exist and work as they did before.
Your end users will need to refresh their web browsers after the upgrade happens, so you may want to upgrade at off-hours.
There are important differences if the workspace has installed or published content packs, these are described below at a high level, and more extensively in the documentation.
What are the biggest changes to be aware of after upgrade?
Firstly, your workspace in Power BI isn’t tied to the Office 365 Group anymore. That means that if you delete the Office 365 Group, the workspace won’t be deleted. Also, if you delete the workspace, the Office 365 Group won’t be deleted.
The workspace access list and roles assigned to users are updated. You’ll want to review these after upgrade to make sure you understand the changes. The Owners of the Office 365 Group are added as Admins of the workspace. The members of the Office 365 Group are not added individually to the workspace access list. Instead, the Office 365 Group is added with the appropriate workspace role.
In most cases, the Office 365 Group will be given the Member role. However, if your workspace is ‘read-only’ then they’ll be given the Viewer role.
You will want to review the permissions after upgrade section in the documentation to familiarize yourself with the details.
What happens if I’m still using content packs?
The new workspace experience doesn’t support content packs. Instead, use apps and shared datasets to distribute content in the workspace. We recommend removing published or installed content packs from the workspace prior to upgrade.
However, if there are published or installed content packs when you upgrade, the upgrade process attempts to preserve the content. The top thing you should know is that we copy the content so it’s still available to users, but it won’t update any more. Because we copy the content URLs to items in content pack will change so you’ll need to distribute new URL to anyone you shared those items to. There is no way to restore the content pack or the association of content to the content pack after you upgrade. If you are still using content packs read through the documentation which covers what happens in detail.
Can I move my organization entirely off classic workspaces?
The public preview allows upgrading individual workspace. It doesn’t provide tools for bulk upgrade. New Office 365 Groups will continue to be listed as workspaces in Power BI. For organizations wanting to move their workspaces, the documentation offers some suggested approaches for doing so.
Can I go back to a classic workspace after the upgrade?
For 30 days after the upgrade, you can use the go back to classic workspace option to return to an Office 365 Group based workspace. When you do this, some aspects of your classic workspace won’t be restored, like content packs. You’ll want to learn more about going back to a classic workspace since there are a number of cases when you won’t be able to go back.
Next Steps
Learn more about upgrading classic workspaces in Power BI
Learn more about the new workspace experience