---
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


---

# Configure a relationship data item for an embedded list

# Configure a relationship data item for an embedded list {#ariaid-title1}

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

Configure relationship data items so you can control the information that appears in
embedded lists within a record screen.

## Before you begin

Role required: admin

## About this task

A relationship data item is required to create an embedded list. Embedded lists are
lists that can be embedded within a record screen. For more information on embedded
lists in mobile, see [Embedded lists for a record screen](https://servicenow-prod.fluidtopics.net/huLNPXxUyxUIkjYb~EeoYw "Use an embedded list to place a list of information that is related to your current record within a segment on your record screen so that your users don't have to navigate to a related list.").

## Procedure

1. Navigate to AllSystem MobileMobile App Builder.  
   The Mobile App Builder opens in a new browser tab and displays the application scope selection screen.
2. Search for the application scope you are working in and then select the name of the application scope.  
   The Mobile App Builder categories home screen displays.
3. Select the Data category from the menu, and then select New.
4. Select the Relationship data item icon, and then select Continue.
5. Complete the following fields as needed.  
   {#sg-data-item-relationship__table_cbg_pzm_42b__entry__2}

   | Field | Description |
   |-|-|
   | Properties section: ||
   | Name | A title for the data item. You can have multiple data items with the same name. Make sure that this name is unique so that you can find it easily. |
   | Description | Optional additional details about the data item. |
   | Data section: ||
   | Table | The table you want the data item to pull information from. This table is the table of records that is embedded as list on the parent record screen. Note: Custom tables are not available by default. You can change this behavior by modifying the subscription.custom_table.enforce_entitlement system property. For details on making this change, see [Allow or restrict access to custom tables in mobile data items](https://servicenow-prod.fluidtopics.net/NfmLbFkC8ztMAEuXdJ_Uxw "Use system properties to control whether custom tables are available when creating or modifying data items."). |
   | Group by | Groups query results based on the selected field from the menu. |
   | Table related to | Table that the records in this data item are related to. For example, for a list of Task SLA records embedded into a task record screen, the Tables related tovalue would be the <kbd class="ph userinput">Task</kbd> table. |
   | Relationship | Relationship between the table selected in the Table field and the table selected in the Table related to field. |
   | Condition type | Determines what type of condition your data item uses. Select from: Declarative :   Use a declarative condition to create conditions for the data item using the condition builder. Scripted :   Use a script to determine the conditions of your data item. A text window to enter a script appears below this field when you select this option. Append Encoded Query :   Use this option only when creating data items for your chart screens. For details on that data item type, see [Configure an encoded query data item for chart screens](https://servicenow-prod.fluidtopics.net/PYG2VLGGfOxuj_fYTCT~8A "Configure an encoded query data item to query data for chart screens. An encoded query data item is a parametrized data item that is the basis for a chart screen to be passed to a list screen. When tapped it enables users to drill-down to a list of items that the chart is created from."). |
   | Condition | Set of conditions for the data item to conform to. You can create conditions using the [condition builder](https://www.servicenow.com/docs/access?context=c_ConditionBuilder&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US). Note: This field is only available when you select `Declarative` in the Condition type field. |
   | Sort by | Lets you adds fields to the form that allow you to configure how to sort the list. In the condition builder, select the field you want the list to be sorted by. For example, select <kbd class="ph userinput">Caller</kbd>. Then select <kbd class="ph userinput">ascending</kbd> or <kbd class="ph userinput">descending</kbd> to determine the order of the list. Note: This field is only available when you select `Declarative` in the Condition type field. |
   | Parameters | Note: The Parameters field must not be used for relationship data items. |
   [Table 1. Relationship data item fields]

   {#sg-data-item-relationship__table_cbg_pzm_42b}
6. **Optional:** If you have selected Scripted in the Condition type field, you must create a script in the Query Condition Script field.  
   Your scripted condition must return a query string, which the instance uses
   to filter the data item. Use the `input` variable to access
   information from the current record.

       (function getQueryString(input) {
       	var queryString = '';
       	if(input.company) {
       		  queryString += "company="+input.company;
       	 }
       	if(input.location) {
       	  queryString += "^location="+input.location;
       	 }
               queryString += "^EQ^ORDERBYDESCsys_updated_on";
       	 return queryString; 
        })(input);

   This example uses the `input` variable and filters the data
   item for records matching the current records company and location. It then
   appends the text `^EQ^ORDERBYDESCsys_updated_on` to the
   query, which sorts the data item records by the Updated on field.  
   Note:  
   The `input` variable provides mobile scripts access to values that are passed in the SubmittedForm or the ParameterData objects.
7. Select Save.

## What to do next

After creating a relationship data item, create a list screen using this newly
created data item. For more information, see [List screen configuration](https://servicenow-prod.fluidtopics.net/gISd3nnYKhWRLpG~7Z9KXg "Configure a list screen so that your users can see a list of records from their mobile app. To access a record from the list, a user can tap the record name.").

*[\>]: and then