Edit

Share via

Power Pages DevTools extension

  • Article

The Power Pages extension for Microsoft Edge DevTools is a developer tool designed to enhance the development and troubleshooting experience for makers and administrators working on Power Pages sites. It offers features such as displaying Liquid tracing message and server-side error messages. With this tool, makers and administrators can efficiently identify, diagnose, and resolve issues within the Power Pages environment. By enabling logging and tracing capabilities in liquid code, as well as providing clear insights into error scenarios, the Power Pages extension facilitates smoother development workflows and enhances the overall quality of Power Pages sites.

Note

The developer tool extension is currently only available for Microsoft Edge.

To work with the developer tools, you need to:

  • Install the browser extension.
  • Enable diagnostic setting.
  • Review server-side error and follow mitigation details.
  • View custom log messages added using Liquid code.

Install the browser DevTools extension

To install the DevTools extension for Power Pages:

  1. Go to Microsoft Power Pages extension for Microsoft Edge.
  2. Select Get.

Enable diagnostic setting

Note

If your site visibility status is private, the diagnostic setting is enabled by default.

To enable the diagnostic setting for a public website:

  1. Open the Power Pages Management App.
  2. Add or update the Site Setting with the name UserTrace/Debug.
  3. Set the value to true.

Review server-side error messages

When you enable the diagnostic setting, the platform logs any errors that occur on the server. To capture these server error messages, you need to:

  1. Open the Microsoft Edge web browser.

  2. Navigate to your Power Pages website.

  3. Open the browser DevTools.

  4. Select the Power Pages tab.

    Screenshot of the Microsoft Edge DevTools with the Power Pages tab selected.

  5. Reproduce the scenario where you encountered the error.

The tool displays a list of all server-side error messages along with probable resolutions.

Note

Currently, you may only see a limited number of failure error messages. However, each subsequent release will include additional error messages for various types of failures.

The following are some example error messages:

  • Error with Local sign-in provider if the LogonEnabled attribute is false for the Portal contact.

    Screenshot of the Microsoft Edge DevTools with the Power Pages tab selected and an example error message displayed.

  • Search for external entity isn't configured properly.

Log custom messages with Liquid

Makers can add log statements in their Liquid code. When the Power pages site is running, the logs added by maker in Liquid code are shown in the Power Pages developer tool extension. Learn more in Available Liquid objects.