Loading

Add a Related List to a Dedicated Tab on a Lightning Record Page

Date de publication: Apr 2, 2026
Description

A business tracks Vendor Product details related to their Accounts on a custom object called Vendor Products. The business would like to display related Vendor Product data on a dedicated tab on the Account Lightning Record Page so that users can easily access and review the information

Résolution

We can solve for this by adding a Tab to the existing Tabs component on the Account Lightning Record Page, and then adding a Related List Single component to the new Tab. Then we select the Vendor Product related list to display the records related to the Account within the Tab. 

Step 1:

  1. Check that the Account page layout has the Vendor Product related list added to the layout this is necessary in order to display the records on the record page, and if we attempt to add the Related List single component for Vendor Products without having the Related List on the Account Page Layout, we will receive an error letting us know that the related list is not on the layout
  2. Navigate to Setup -> Object Manager -> Account -> Page Layouts -> Select the Layout in use -> Click Related Lists -> Ensure that the Vendor Products or whichever Object you need to add has been added to the layout.
  3. If the related list is not present, drag it to the related list section and save the layout

 

Screenshot showing the Account Page Layout editor in Salesforce Setup with the Vendor Products related list visible in the Related Lists section at the bottom of the layout.

 

Screenshot showing the Salesforce Setup navigation path: Object Manager > Account > Page Layouts, with the relevant Account page layout selected.

 

Screenshot showing the Related Lists section of the Account page layout with the Vendor Products related list added and visible.

 

Step 2:

  1.  Navigate to an Account record and click the Setup Icon -> Edit Page

 

Screenshot showing an Account record in Salesforce with the Setup gear icon clicked and the Edit Page option highlighted in the dropdown menu.

 

Step 3:

  1. Click on the tabs component on the lightning page, and then click Add Tab to create a new Tab within the component
  2. Scroll to the top and select Custom, then create a label specific to the object we want to display in this case, we will call it Vendor Products. Click Done to add the tab to the component

Screenshot showing the Lightning App Builder with the Tabs component selected on the Account Lightning Record Page and the Add Tab button highlighted in the right-hand properties panel.

 

 

Screenshot showing the Add Tab dialog in Lightning App Builder with the Custom option selected and the label field filled in as Vendor Products, with the Done button visible.

 

Step 4:

  1. While still in the page editor navigate to the New Tab. You may need to click More if you have multiple tabs already
  2. Then find the Related List Single component and drag it to the empty tab where it says Add Components Here

 

Screenshot showing the Lightning App Builder with the new Vendor Products tab selected and the Related List Single component being dragged from the component panel into the Add Components Here drop zone.

 

Step 5:

  1. Click on the newly added Related List Single component, and then from the right hand side, choose the Vendor Products related list from the Related List dropdown
  2. Optionally, choose what type of related list you would like to display in this example, we have chosen to use an Enhanced Related List

 

Screenshot showing the Related List Single component selected in Lightning App Builder with the Related List dropdown on the right panel set to Vendor Products and the Enhanced Related List display type selected.

 

Step 6:

  1. Click Save in the top right to save your changes, then navigate back to the page. We should now see a dedicated Vendor Products tab with a related list displaying the records within that tab

 

Screenshot showing the saved Account Lightning Record Page with the new Vendor Products tab visible in the tab bar alongside other existing tabs.

 

Screenshot showing the Vendor Products tab on the Account Lightning Record Page displaying the Related List Single component with Vendor Product records listed within the dedicated tab.

 

 

Ressources supplémentaires

 

 

Numéro d’article de la base de connaissances

003379474

 
Chargement
Salesforce Help | Article