Run Portal Checker

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.

Identifying web pages listed in diagnostic results

The portal checker diagnostic results could list web pages that have the same name as other pages in the portal. If there are multiple web pages with the same name, you can identify the specific page affected using the unique guid of the page.

  1. Open the Portal Management app.

  2. In the left pane, select Web Pages.

  3. Open any web page.

  4. Replace the ID in the URL with the guid specified in the portal checker diagnostic results.

    Replacing the web page ID the URL.

Next steps

Analyze and resolve Portal Checker diagnostics results: