---
sourceDocument: Yokohama Build workflows
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/build-workflows

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Build workflows

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# Show List of Records activity

# Show List of Records activity {#ariaid-title1}

Release version: Yokohama  
Updated January 30, 2025  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Show List of Records activity

The Show List of Records activity in ServiceNow Yokohama release enables you to display a list of records that meet specific conditions within a playbook.
This activity is commonly used to present relevant records to end users, facilitating decision-making and task management directly within the playbook experience.
Show full answer Show less  

## Key Features

* **Role and Access:** Available as a common activity; users with admin, playbook.admin, or pdauthor roles can add and configure it in playbooks.
* **Configurable Inputs:**
  * **Label and Description:** Customize the title and informational text displayed on the activity card.
  * **Run Condition:** Define conditions using prior activity data to control when the activity or stage runs.
  * **Start Rule:** Set the timing for when the activity or stage begins, such as immediately when the process or stage starts, or after specific stages or activities complete.
  * **Start with Delay:** Optionally delay execution for a set duration.
  * **Table Selection:** Specify the table containing the records to display.
  * **Fields to Show:** Choose which fields appear as columns in the list using a comma-separated list.
  * **Wait for User Input:** Option to pause the playbook until the end user manually completes or skips the activity, editable only by playbook.admin role holders.
* **Advanced Inputs:** Additional optional settings include assigning the task to a group or user and specifying detailed conditions for filtering the list of records.
* **Outputs:** The activity outputs include a reference to the selected record and a list of fields displayed, which can be consumed by subsequent activities in the playbook.

## Practical Application for ServiceNow Customers

ServiceNow customers can use this activity to dynamically display filtered lists of records within a playbook, improving user engagement and streamlining workflows by presenting only relevant data. The flexible scheduling and condition options help tailor the activity's execution to complex process requirements. Additionally, the ability to pause for user input allows for interactive decision points, enhancing control over process progression.  
Display a list records that match a set of conditions.

## Roles and availability {#show-list-of-records-activity__section_pwq_rb5_kcb}

* This activity is available as a common activity. Users with the admin, playbook.admin, or pd_author can add this activity to a playbook.
{#show-list-of-records-activity__ul_mcq_1c5_kcb}

## Inputs {#show-list-of-records-activity__section_yb4_zq3_plb}

Open the activity properties panel and configure your activity to add values for the following inputs. If the input value varies, use the pill-picker to show where to get the value. To learn more about the pill-picker, see [Dot-walking examples](https://www.servicenow.com/docs/access?context=dot-walking-examples&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US). {#show-list-of-records-activity__table_ajt_sr3_plb__entry__3}{#show-list-of-records-activity__wait-process}

| Input | Type | Description |
|-|-|-|
| Label | String | Title to display as activity and playbook card. |
| Description | String | Information to display about activity usage or outcome. |
| Run condition | Condition Builder | Conditions that must be met to run an activity or stage. You can use data from prior activities to build conditions. Note: Show additional options to see this field. |
| Start Rule | Choice | Under ScheduleStart Rule, select a start rule for when your stage should start running: * When process starts: Your stage starts running as soon as the playbook starts. * After specific stages: Your stage starts running after specified stage(s) have finished running. {#show-list-of-records-activity__ul_f4z_nq1_ppb}Under Schedule \> Start Rule, select a start rule for when your activity should start running: <!-- --> * When stage starts: Your activity starts running as soon as its stage starts running. Your stage starts running when your playbook is triggered. * After specific activities: Your activity starts running after specified activities have finished running. {#show-list-of-records-activity__ul_zzc_3ls_m1c} |
| Start with delay | True/False | Option to wait for a duration of time before running an activity or stage. When enabled, this input displays the [Start with delay input properties](https://servicenow-prod.fluidtopics.net/ZO5_TxRewwK7XqnX5otC7A "Specify a duration of time to wait before running an activity or a stage whose start rule and conditions have been met. Give users time to act during automated playbooks. Give users time to wait for a specific date and time to complete actions."). Note: Show additional options to see this field. |
| Table | Table Name | Table containing records you want to display to end users. |
| Fields to show | String | Comma-separated list of fields to display as columns of a list. |
| Wait for user input | Choice | Option to pause the playbook until the end user manually completes or skips the activity. Only users with the playbook.admin role can edit this field. By default, the activity waits for user action or data before it completes. |
[ ]

{#show-list-of-records-activity__table_ajt_sr3_plb}

## Advanced inputs {#show-list-of-records-activity__section_bgh_1r3_plb}

After configuring the required inputs for your activity, you can also choose to configure additional inputs. In the side panel, select Show additional options to display these advanced inputs. For more information, see [Activity experience](https://servicenow-prod.fluidtopics.net/r014Lhz_11xoMRZZRHOzcA#activity-definitions__activity-experience). {#show-list-of-records-activity__table_cjj_sr3_plb__entry__3}

| Input | Type | Description |
|-|-|-|
| Assignment Group | Reference.Group \[sys_user_group\] | Group responsible for completing the task associated with the activity. Note: Show additional options to see this field. |
| Assigned To | Reference.User \[sys_user\] | User responsible for completing the task associated with the activity. Note: Show additional options to see this field. |
| Conditions | Condition Builder | Criteria that you want your list of records to meet. |
[ ]

{#show-list-of-records-activity__table_cjj_sr3_plb}

## Outputs {#show-list-of-records-activity__section_unx_fr3_plb}

These outputs can provide data to other activities in your playbook. You can access this data as activity inputs when you configure your activity: {#show-list-of-records-activity__table_mv2_rr3_plb__entry__3}

| Output | Type | Description |
|-|-|-|
| Record | Reference.Task \[task\] | Reference to the record associated with the activity. |
| Fields | String | Comma-separated list of system field names to display as columns in the list. |
[ ]

{#show-list-of-records-activity__table_mv2_rr3_plb}

*[\>]: and then