---
sourceDocument: Australia Mobile Configuration and Navigation
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/mobile

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Mobile Configuration and Navigation

ft:clusterId :

    - mobile

bundleId :

    - mobile

workflow :

    - Development, Data and Analytics


---

# Display a related list

# Update your record screen to display a related list {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Update your record screen to display a list of related records.

## Before you begin

Role required: admin

## Procedure

1. Navigate to AllSystem MobileMobile App Builder.  
   The Mobile App Builder appears in a new browser tab and displays the application scope selection screen.
2. Search for the application scope you're working in and then select the name of the application scope.  
   The Mobile App Builder categories home screen displays.
3. From the menu on the left side, select Screens to display the data items for the scope.
4. Open the screen record where you want to display your embedded list.
5. In the control panel, find the Record screen segments list and click New.
6. Select Record screen section in the Create a record screen segment window.
7. In the record screen segment, use the Order field to choose where to display embedded list on your record screen.  
   Segments display using the value in the Order field from lowest to highest.
8. In the Embedded screen section, click New.
9. Select Related Lists in the Create a screen window.
10. In the New related lists screen, fill in the following fields.  
    {#sg-create-related-list-3__table_np4_54l_5wb__entry__2}

    | Field | Description |
    |-|-|
    | Name | Name of the related list |
    | Description | Description of the related list. |
    | Show count | Whether the screen displays a count of records in the list |
    | Hide screen name | Whether to display the screen name for the related list |
    | Available offline | Whether the list is accessible in offline mode. |
    | Table | Select the table to use. Important: Select the table used in the record screen, not the table for the records within the list. For example, if you're creating a list to display incidents related to a problem, select the Problem table. |
    | Icon | Choose an icon for the related list. |
    [Table 1. Related lists screen fields]

    {#sg-create-related-list-3__table_np4_54l_5wb}
11. In the Related list mapping section, click New.  
    In the next steps, you map a connection between this related list and the list screen that you created in the steps under [Create a list screen to use as a related list](https://servicenow-prod.fluidtopics.net/XHOaA3VbOBX1t4u3uRjo9g "Create a related list using your parametrized data item. This list appears for your users when they select the related list tab on their form screen.").
12. In the Related list map panel, select a relationship in the Relationship field.  
    This field creates the relationship between the table used in the record screen, and the table used for the records within the related list. For example, for a list of incidents related to a problem, you choose Incident-\>Problem.
13. In the Destination screen section, click the Choose button and select the list screen you created in the previous steps.

## Result

Your screen displays a tab for your related list. Users tap this tab to see records on that list.  
Note:  
If you selected Show count in the related list screen field section, the screen displays a counter number in the related lists. This number relates to the number of records based on your selections in the Related list maps section.

The number of related records shown in a selected
destination screen can be less or equal to the counter number displayed in the related list. The lower number of records is due to additional conditions applied to the list.

## Example

Continuing the preceding example, the problem record screen must have a related list. In the Related list maps section, you select the Incident-\>Problem relationship. Under
Destination Screen, you select the related incident list created in the previous steps. After logging out and back in again, you have a related list on your problem record screen, which displays a list
of incidents related to that problem.

*[\>]: and then