Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

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 for more information.

  • List banner button: Creates a button on the banner of a list.
Image omitted: atf-list-banner-button.png
Image showing the list banner button
  • List bottom button: Creates a button at the bottom of the list.
Image omitted: atf-bottom-button.png
Image showing list bottom button
  • List context menu: Adds an option to the context menu of the list.
Image omitted: atf-list-context-menu.png
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.
Image omitted: atf-list-choice.png
Image showing the added option in the list
  • List link: Adds a link to the Related Links list.
Image omitted: atf-list-link.png
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