Scenario
A custom child record is linked to a parent record, but the child records do not appear on the parent record page.
Common symptoms include:
- The child records exist and can be opened directly.
- The relationship is configured correctly, but no subtab appears.
- Some users can see the child records while others cannot.
- The child record appears in Sandbox but not in Production.
This is a common issue in SuiteBuilder when parent-child relationships, permissions, or form configurations are incomplete.
Solution
Review the custom record relationship and form configuration controlling how child records display on the parent record.
Common causes include:
- Parent Record Relationship Not Configured
- Open the child custom record type configuration.
- Verify the correct parent record field is selected under the record relationship settings.
- Allow Child Record Editing or Viewing Settings
- Certain child record display options may not be enabled.
- Review whether the child record is configured to display as a sublist on the parent.
- Custom Form Configuration
- The subtab or sublist may not be added to the parent form.
- Test using a standard form where possible.
- Permissions
- Users must have permission to both:
- The parent record
- The child custom record type
- Missing child record permissions commonly prevent visibility.
- Saved Parent Reference Missing
- Existing child records may not actually contain a populated parent reference field.
- Verify the parent field contains valid linked records.
- Inactive Child Records
- Inactive child records may not display depending on account configuration and filters.
- Scripts or Workflows
- Custom scripts or workflows may hide subtabs or alter related record behavior dynamically.
- Role or Subsidiary Restrictions
- Visibility may vary by role, department, subsidiary, or audience restrictions.
Notes
Custom child record visibility depends on both the relationship setup and the user’s ability to access the related records. Even correctly configured relationships may appear broken if permissions or forms differ between roles.
When troubleshooting:
- Test using the Administrator role.
- Verify the parent reference field directly on the child record.
- Compare standard versus custom forms.
- Review workflows and scripts affecting the parent record page.
- Confirm the child record type is active and accessible.
Testing relationship changes in a sandbox environment is recommended before updating production configurations.