Error Reference

Related list missing from form: expected related list not visible

Related list missing from form: expected related list not visible

Where this appears

This error typically appears in browser console logs or system application logs when a user accesses a form where an expected related list should be displayed. The error occurs during form rendering when ServiceNow cannot display a configured related list due to access restrictions, configuration issues, or relationship problems.

Sourdough
Chrome Extension

Debugging this in a real instance?

Sourdough lets you trace "Related list missing from form: expected related list not visible" through system logs, script errors, and API health in the ServiceNow tab you are already using.

Add to Chrome

Free to install. Pro $5/month after a 14-day no-card trial.
Pro requires the ServiceNow admin role. Upgrade inside the extension.

Overview
Tasks
CMDB
API
Metrics
Monitor
Internals
Instance:sourdoughdev·Version:Yokohama
Instance StateONLINE
System StatusFully Operational
Session Timeout90 minutes
Logged-In Sessions2 (20 active)
Build Nameyokohama-12-18-2024_p1
IP Address10.159.128.43
Instance HealthHealth Score: 90%
🔥 5dSourdough (Chrome Plugin)Dark Mode

Cause

Access Control Lists (ACLs) are blocking read access to the related table or specific fields within the related list. (high likelihood)

The related list was removed from the form layout for the specific view or user role accessing the form. (high likelihood)

The table relationship definition is inactive or incorrectly configured in the Dictionary Entry or Reference field setup. (medium likelihood)

User interface policies or client scripts are dynamically hiding the related list based on form conditions or field values. (medium likelihood)

The related list configuration has an invalid filter condition or query that returns no results and causes display issues. (low likelihood)

Fix

Step 1: Navigate to the affected form and right-click to select Configure > Form Layout to verify the related list is present in the form configuration.

Step 2: Check System Definition > Tables & Columns and verify the relationship field exists and is active between the parent and child tables.

Step 3: Go to System Security > Access Controls (ACL) and search for ACLs on the related table to ensure the current user has read access.

Step 4: Test with an admin account to determine if the issue is role-based, then review the user's roles and group memberships in User Administration.

Step 5: Examine any UI Policies under System UI > UI Policies that might be hiding the related list based on form field conditions.

Step 6: Review client scripts and business rules that might be manipulating the form's related lists using g_form.removeOption or similar methods.

Step 7: Check the related list configuration by navigating to the form, right-clicking the related list area, and selecting Configure to verify filter conditions.

Step 8: Clear browser cache and test in an incognito window to rule out client-side caching issues affecting form rendering.

Test Your Knowledge

Quick 3-question quiz. See how your ServiceNow skills stack up.

Question 1 of 3Performance

A list view on a table with millions of records is slow. Best fix?

Select an answer to continue