Display custom error page in PowerApps portals/ Dynamics 365 Portals

Follow my blog for more interesting topics on Dynamics 365, Portals and Power Platform. For training and consulting, write to us at info@xrmforyou.com

In this blog, I will explain how to display a custom error page in PowerApps portals or Dynamics 365 portals.

This blog is basically a sub-topic of this blog here. In that blog, I explained in-depth the complete error management in PowerApps Portal. I strongly suggest to read that blog to be with the flow.

If you have read my linked post on Portal error management, you are aware of the option to enable or disable custom errors.

When you enable custom errors and if an exception happen, you see a generic message like the one below.

Custom error page in PowerApps portals

What if you want to show something more specific? May be a custom error message but highlighting your company support email or contact person. Basically personalize the custom error page.

Fortunately this is possible. So let’s see on how we can do it.

The first step is to enable Custom errors for the portal. I skip the details here. You can refer my linked blog here.

The next step is to set-up the custom error page. For this, you would need to open the Portal Management app. To accomplish this, navigate to PowerApps maker portal, select “Portal management” app and then click on Play.

Custom error page in PowerApps portals

You may find the name of the app as “Dynamics 365 Portals” as well. It’s basically the same app.

You will also like the below posts

Instead of generic error screen you can configure a user friendly professional custom error. To define your error, under Content-> Content Snippet, create a content snippet named “Portal Generic Error”. Choose the type of content snippet as Text or HTML

I have created the content snippet with type as Text. You can choose a beautifully crafted HTML as well.

Custom error page in PowerApps portals

Save the content snippet. Make sure to refresh your portal cache for the changes to be reflected in the portal.

Now once an error happen in the portal platform, the following error message is displayed.

Custom error page in PowerApps portals

Wonderful isn’t it? Also please not that any liquid code written in content snippet will be skipped and will not rendered in your portal error screen.

In this way you can configure customized friendly error messages for end users in your portal.

Check out my recent posts

Hope this helps!
Debajit Dutta
(Business Solutions MVP)