Add Visibility to Related List

July 12 2022 • 25 min read

BUSINESS CHALLENGE

Visibility can be set for components in lightning pages based on criteria. By default the lightning pages use Related Lists component to display the related objects records.

What if you want to display records of a specific object based on criteria in the related list. The Related Lists is a single component. Visibility cannot be set for individual related object’s records.

To overcome this, we can use a Related List - Single component for each individual related object's records and then visibility criteria can be set.

WHAT IS “RELATED LISTS”

Related Lists is a standard component that displays records with a lookup or master-detail relationship to another record, like a section of a record detail page that lists all the items related to that record.

WHAT IS “RELATED LIST - SINGLE”

The Related List - Single component shows a list of related records based on one specific object. For the Contact detail page, you can specify to see the cases related to that Contact, without seeing all other types of related records.

WHY DO WE NEED A RELATED LIST - SINGLE COMPONENT?

What if you want to show Approval History information only for the opportunity owner. In case of Related Lists, one component displays all the related records information. Visibility can only be set for each individual component.

In order to solve the problem, we can use multiple Related List - Single components for each related Object’s records and then set the visibility for specific component.

STEPS TO ACHIEVE THE REQUIREMENT

Create a Custom Field ( to control component visibility )
Add the Related List - Single component to lightning record page

CREATE CUSTOM FIELD

Click Gear Icon → Click Setup.
Select Object Manager → In the Quick find search and Select Opportunity.
Select Fields and Relationships → Click New.
Select Formula as data type → Click Next.
Enter Approval History Visibility as Label → API Name will be Automatically Populated. Here we named the field as Approval History Visibility because we are going to control the visibility for Approval History. It can be named as per the requirement.
Select Check Box as the Formula Return Type.
Click Next.
Enter the below mentioned formula. This formula updates the fields Checkbox value to Checked if the user who is viewing the record is the Opportunity Owner, else it updates the field value to Unchecked.

“ IF($User.Id = Owner.Id, True, False)”
Click Next.
Check the Visibility for required Profiles. For the Profiles which need only read access check both Visible and Read Only.
Click Next.
This field is created only to control the visibility for the Related List - Single component and this field is not required on the page layout → Uncheck the Add Field checkbox and Click Save.

NOTE

Here a custom field is created in order to determine if the user viewing the record is the Opportunity owner, so that we can control the visibility of the component.

ADD RELATED LIST - SINGLE TO LIGHTNING RECORD PAGE

Select any opportunity record → Click Gear Icon at the top of the page.
Click Edit Page.
On the left pane we have all the available components, drag and drop the Related List - Single standard component onto the page to a required position.
On the right pane select Use this Opportunity for Parent Record option, For Related list option choose the object whose records should be displayed in the component. Here we choose Approval History. For the Related List Type option choose as per requirement.

Please refer to the below images with related contacts for an Opportunity, for the related list types.

In Enhanced Related List Type, You can control the number of rows visibility in the right pane.

Make sure that the component you want to set the visibility, is selected and Scroll down to the bottom on the right pane, Click Add Filter under Set Component Visibility.
Select the field Approval History Visibility as Field, Equal as Operator and True as Value.
Click Save and go back to the record page.
If the user viewing the record is the Opportunity Owner, the Approval History will be visible in the related list.
If the Owner has been changed to any user other than the Opportunity Owner, the Approval History will not be visible in the Related List.