Resolving Blank Page Issue in Portal Experiences

Does your portal experience load a blank page and require a refresh (or several refreshes) before loading any content? This post goes through the steps necessary to resolve the blank page issue.


I was working with a client recently who had a portal experience that was causing them some grief. Every time they visited their portal experience, they were met with a blank page. They had to refresh multiple times in order for the page to load its contents. This was problematic for them as they were trying to close a big deal with a potential customer who was interested in their app. After many conversations with the ServiceNow support team, we were finally able to get some steps to resolve the issue.

Since then, I have seen the same issue pop up time and time again for other portal experiences. Hoping to save others from the same headache, I have outlined the steps that will prevent the blank page issue from happening.

  1. Open your Portal Experience in UI Builder
  2. From the “Settings” tab, click “Advanced Settings” under the “General” section (see image below)
  1. Populate the “Parent App” field on the UX Application (sys_ux_page_registry) record
    1. “UXR Base Unified App” is recommended for globally scoped portal experiences
    2. If you have a portal experience in a scoped app, insert a copy of the “UXR Base Unified App” record in your scope (or create a new record and just copy over the values from the global record)
  2.  Save and test

That’s all there is to it!

Resources

Related Support Article: https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1587073

Corresponding Community Post: https://www.servicenow.com/community/developer-blog/resolving-blank-page-issue-in-portal-experiences/ba-p/2929860