List UI actions test steps

concept brazil Updated Sep 10, 2026 1 min read atf-list-ui-actions-test-step.md

Raw file servicenow.com

Select a UI action from a list to perform different actions on a list or a related list.

You can create a new UI action of the following types. See Create a UI action for more information.

List banner button: Creates a button on the banner of a list.

[Omitted image "atf-list-banner-button.png"] Alt text: Image showing the list banner button
List bottom button: Creates a button at the bottom of the list.

[Omitted image "atf-bottom-button.png"] Alt text: Image showing list bottom button
List context menu: Adds an option to the context menu of the list.

[Omitted image "atf-list-context-menu.png"] Alt text: Image showing the UI action in the context menu
List choice: Adds an option to the list choice at the bottom of the list. You need to select one or more tests to enable the recently added list choice.

[Omitted image "atf-list-choice.png"] Alt text: Image showing the added option in the list
List link: Adds a link to the Related Links list.

[Omitted image "atf-list-link.png"] Alt text: Image showing the links added to the Related Links list

Design considerations

To use the Click a List UI Action test step, the test first needs to navigate to the list or the form with the related list containing the UI action.
The Related list field appears only when you select Related list as the List type.
Action type is mostly auto-filtered depending on the List action chosen.
The Record field appears only when you select Single record for the UI action to be applied.
Identify the specific record if you have selected Single record to apply the UI action.
For the Timeout field to appear, select Page reloaded or redirected as the Assert type.

Parent Topic:Building and running automated tests with the Automated Test Framework

53 lines · 2.9 KB Wrap lines

---
title: List UI actions test steps
description: Select a UI action from a list to perform different actions on a list or a related list.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/application-development/automated-test-framework-atf/atf-list-ui-actions-test-step.html
release: brazil
product: Automated Test Framework \(ATF\)
classification: automated-test-framework-atf
topic_type: concept
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Building and running automated tests with the Automated Test Framework, Automated Test Framework \(ATF\) test building and execution, Automated Test Framework \(ATF\), Testing and debugging applications, Classic app development, Building applications]
---

# List UI actions test steps

Select a UI action from a list to perform different actions on a list or a related list.

You can create a new UI action of the following types. See [Create a UI action](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-administration/t_EditingAUIAction.md) for more information.

- **List banner button**: Creates a button on the banner of a list.

\[Omitted image "atf-list-banner-button.png"\] Alt text: Image showing the list banner button

- **List bottom button**: Creates a button at the bottom of the list.

\[Omitted image "atf-bottom-button.png"\] Alt text: Image showing list bottom button

- **List context menu**: Adds an option to the context menu of the list.

\[Omitted image "atf-list-context-menu.png"\] Alt text: Image showing the UI action in the context menu

- **List choice**: Adds an option to the list choice at the bottom of the list. You need to select one or more tests to enable the recently added list choice.

\[Omitted image "atf-list-choice.png"\] Alt text: Image showing the added option in the list

- **List link**: Adds a link to the **Related Links** list.

\[Omitted image "atf-list-link.png"\] Alt text: Image showing the links added to the Related Links list

## Design considerations

- To use the **Click a List UI Action** test step, the test first needs to navigate to the list or the form with the related list containing the UI action.
- The **Related list** field appears only when you select Related list as the **List type**.
- **Action type** is mostly auto-filtered depending on the **List action** chosen.
- The **Record** field appears only when you select **Single record** for the UI action to be applied.
- Identify the specific record if you have selected **Single record** to apply the UI action.
- For the **Timeout** field to appear, select **Page reloaded or redirected** as the **Assert** type.

**Parent Topic:**[Building and running automated tests with the Automated Test Framework](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/automated-test-framework-atf/atf-build-overview.md)