How to Unpublish Power BI App
Removing a Power BI app from your users' view is sometimes necessary, whether you're making major updates, fixing a bug, or retiring an old report. This guide walks you through exactly how to unpublish a Power BI app, explains what happens when you do, and offers a few best practices to ensure a smooth process for everyone involved.
Why Unpublish a Power BI App?
While the "Update app" function is great for pushing small changes, sometimes a full unpublish is the better option. It gives you, the creator, complete control over who sees what and when. Here are a few common scenarios where unpublishing makes sense:
- Major Overhauls: If you're fundamentally changing the report's design, navigation, or data sources, you might want to take it offline to avoid confusion while you work. Unpublishing prevents users from accessing a broken or incomplete version.
- Retiring an App: When a report or dashboard is no longer relevant, accurate, or has been replaced by a newer version, unpublishing is the best way to officially decommission it and clean up the workspace.
- Troubleshooting Data Issues: If you discover a critical error in your data or calculations, unpublishing the app immediately stops anyone from making decisions based on faulty information. You can work on a fix behind the scenes and republish when it's resolved.
- Temporary Access Restriction: Maybe you only want a report to be available at the end of the month or during a specific project phase. Unpublishing gives you a simple on/off switch for its availability.
Comparing Concepts: Updating vs. Unpublishing an App
It's important to understand the difference between updating and unpublishing an app, as choosing the wrong one can lead to different user experiences.
Updating an App: This action pushes a new version of your report and dashboard package to the same audience. Anyone who already has access will simply see the new version the next time they open it. It's the standard process for iterative improvements, like adding a new visual, fixing a typo, or tweaking a filter.
Unpublishing an App: This action completely revokes access to the app for all users. It disappears from their "Apps" list in Power BI Service, and any direct links they have saved will no longer work. The underlying reports and datasets in your workspace are unaffected, but the published "package" is taken offline entirely.
Think of it like a website. Updating is like pushing a change to a live webpage. Unpublishing is like taking the entire website offline, displaying a "404 Not Found" error to anyone who tries to visit.
Your Pre-Flight Checklist: Before You Unpublish
Before you hit the unpublish button, taking a couple of minutes to prepare can save you from future headaches and confused emails. Run through this quick checklist first.
1. Communicate with Your Users
Don't leave your users in the dark. If the app is actively used, send out a quick email or message letting them know it will be unavailable. Briefly explain why (e.g., "We are performing a major update to the Q3 Sales Report") and, if possible, provide an ETA for when it will be back online. This proactive communication builds trust and prevents a flood of support requests.
2. Confirm Your Workspace Permissions
You can't unpublish an app you don't have the proper permissions for. To unpublish an app, you need to have an Admin, Member, or Contributor role in the workspace where the app was published. If you only have a "Viewer" role, you won't see the option to make any changes.
3. Back Up Your Work (Just in Case)
To be clear: unpublishing an app does not delete the reports, dashboards, or datasets in your workspace. All of your original work remains safe. That said, it's always a good practice in data management to have local backups of your key reports. Simply open the report in Power BI Desktop and save a .PBIX file to your machine before making major changes. It's a small step that can be a lifesaver in rare cases.
Step-by-Step Guide: How to Unpublish a Power BI App
The process of unpublishing an app takes less than a minute. The option can feel a little hidden if you don't know where to look. Follow these steps to get it done.
- Log in to Power BI Service Open your browser and navigate to https://app.powerbi.com. Make sure you are logged in to the account associated with the app you want to remove.
- Navigate to the Correct Workspace On the left-hand navigation pane, click on Workspaces. From the list, select the workspace that contains the app you want to unpublish. A list of all the reports, dashboards, and datasets in that workspace will appear.
- Open the 'Update App' Menu In the upper-right corner of your workspace screen, you'll see a yellow button that says Update app. Yes — even though our goal is to unpublish, this is the button we need to click. It will take you into the app publishing settings menu.
- Locate and Click 'Unpublish app' After clicking "Update app", you'll be taken to the app setup screen where you can edit navigation, permissions, and other details. Look to the top-right corner of this screen. You should see an option with a small trashcan icon labeled Unpublish app. Click that option.
- Confirm Your Decision A confirmation dialog box will pop up to make sure you didn't click the button by accident. It will warn you that this will delete the app and remove access for all users. Click the Unpublish button to finalize the action.
And that's it! The app is now unpublished and no longer visible to your audience.
What Happens After You Unpublish?
The moment you confirm, the following changes take effect:
- For App Users: The app is immediately removed from their "Apps" section in Power BI Service. Any bookmarks or direct URLs they have saved will now lead to an error page. For all intents and purposes, the app is gone for them.
- For You (The Creator): All your hard work remains safe in your Power BI workspace. The reports, dashboards, datasets, and dataflows are completely untouched and still available to anyone with access to the workspace itself. You can continue editing and refining them.
Re-publishing Your App Later
When you're ready to share your updated report with users again, the process is nearly identical to publishing it for the first time. Just navigate back to the same workspace, click the Update app button again, and configure your settings (like navigation and permissions) before clicking "Update app" to send it live. Users who previously had access may regain it automatically depending on your permission settings.
Final Thoughts
Unpublishing a Power BI app is a straightforward way to manage content and ensure your audience only sees data and reports that are accurate, relevant, and ready for use. By following the simple steps of navigating to your workspace and using the unpublish option, you can easily control the availability of your apps while you work on updates or retire old assets.
As you scale your reporting, managing dozens of dashboards and user permissions across tools like Power BI can turn into a full-time job. We created Graphed to remove this complexity entirely. Instead of wrestling with workspaces and access levels, you can simply connect your data sources (like Google Analytics, Shopify, or Salesforce) and use plain English to build and share real-time reports instantly, focusing on getting insights, not managing another complicated tool.
Related Articles
What SEO Tools Work with Google Analytics?
Discover which SEO tools integrate seamlessly with Google Analytics to provide a comprehensive view of your site's performance. Optimize your SEO strategy now!
Looker Studio vs Metabase: Which BI Tool Actually Fits Your Team?
Looker Studio and Metabase both help you turn raw data into dashboards, but they take completely different approaches. This guide breaks down where each tool fits, what they are good at, and which one matches your actual workflow.
How to Create a Photo Album in Meta Business Suite
How to create a photo album in Meta Business Suite — step-by-step guide to organizing Facebook and Instagram photos into albums for your business page.