---
sourceDocument: Zurich ServiceNow AI Platform user interface
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/platform-user-interface

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich ServiceNow AI Platform user interface

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# List or related list action

# Create a list or related list action button {#ariaid-title1}

Release version: Zurich  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Create a list or related list action and add the button to a workspace.

## Before you begin

Role required: admin

## Procedure

1. Navigate to AllDeclarative ActionsCreate new action.
2. Select List or Related List.  
   A new Action Assignment record opens.
3. Complete the following fields:  

   Action label
   :   The label for the action.

   Action name
   :   Action label populates automatically in all lowercase and with spaces replaced with underscores.

   Implemented as
   :
       * Server Script applies the action to the server or database as JavaScript.
       * UXF Client Action applies the action as a UI Builder page event.
       * Client Script applies the action to the web browser as JavaScript.
       {#create-a-new-list-or-related-list-action__ul_t2c_zrz_m3c}

   Icon
   :   The icon for the action.  
       Note:  
       Select ai-sparkle-fill to add the ServiceNow Otto icon. For hover animation, select the Animate icon check box.

   Button type
   :   The color variant of the action button.  
       Note:  
       AI Primary, AI Secondary, and AI Tertiary are AI gradient variants that visually indicate when users are interacting with AI-powered experiences.

   Record Selection Required
   :   When selected, the action requires one or more records to be selected.

   Application
   :   The scope that the action exists within.

   Table
   :   Table for the action button to appear on.

   View
   :   UI view for the action button to appear on.

   Experience Restricted
   :   When selected, the action is limited to an experience instead of being available across all experiences.

   Active
   :   When selected, the action is active.

   Order
   :   Order in which the action appears relative to other actions.

   Group By
   :   When selected, the action appears under a selected group.

   Group
   :   The group that the action appears under. Applicable when the Group By check box is selected.

   Tooltip
   :   Tooltip text that appears for the action.

   Description
   :   Description of the action for internal reference.
4. Select Submit.

## Result

The list or related list action button appears within the workspace you specified.

## What to do next

Configure a button to apply an action in the following ways:

Trigger a UI interaction from a declarative action
:   Trigger a UI interaction from a declarative action to extend a page without taking ownership.

[Configure dynamic conditions for a list action](https://www.servicenow.com/docs/SjVmDNEAlFUDp9sE9UVjlg "Configure a list or related list action to perform an action only when it satisfies dynamic conditions.")
:   Configure a list or related list action to perform an action only when it satisfies dynamic conditions.

*[\>]: and then