Run Portal Checker


Effective October 12, 2022, Power Apps portals is Power Pages. More information: Microsoft Power Pages is now generally available (blog)
We will soon migrate and merge the Power Apps portals documentation with Power Pages documentation.

Portal Checker is a self-service diagnostic tool that can be used by portal administrators to identify common issues in their portal. Portal Checker helps to identify issues with a portal by looking at various configuration parameters and provides suggestions on how to fix them.

When you run Portal Checker, the results are displayed in the Diagnostic Results section in a grid format. The results grid has the following columns:

  • Issue: Displays the top-level issue faced by a customer; for example, performance issue.
  • Category: Displays the top-level area where issues can be categorized; for example, provisioning or solution upgrade.
  • Result: Displays the status of the issue; for example, error or warning.

By default, information in the grid is sorted by the Result column in this order: error, warning, and pass.

Diagnostic results.

You can expand an issue to view detailed information and mitigation steps. If the mitigation requires any action, you'll see a button that will perform the action. You can also provide feedback on whether the mitigation was useful.

Expand an issue in diagnostic results.

If required, you can rerun the diagnostic checks, which will refresh the results with updated data.


If portal is turned off or IP address filtering is enabled, certain diagnostic checks will not be run on your portal.

For a list of common issues diagnosed by Portal Checker, see Common portal issues diagnosed by Portal Checker and their best practices.

To run Portal Checker:

  1. Open Power Apps portals admin center.

  2. Go to Run Portal Checker.

    Run Portal Checker.

  3. Select the Run Portal Checker button. The diagnostic session will start and gather data about the customer issues. The results are displayed in the Diagnostic Results section.

    Diagnostic results.

  4. To rerun the diagnostic checks, select Refresh results.

    Refresh diagnostic results.

Next steps

Analyze and resolve Portal Checker diagnostics results