logo

NJP

UI Builder Enhancement: Create New Button List with Popup

New article articles in ServiceNow Community · Feb 10, 2026 · article

**Opening a Dialog on Button Click in a List (UI Builder)**

 

**Configuration Steps**

Create the following records via configuration:

 

**1. Action Assignment**

**Table:** **sys\_declarative\_action\_assignment**

- Create a new Action Assignment record.
- Populate the fields as shown in the reference screenshot.


**2. UX Add-on Event Mapping**

**Table:** **sys\_ux\_addon\_event\_mapping**

- **List:** CSM/FSM Workspace → _List Sys ID_
- **Payload:** _List Action Event Payload_



                    

Payload: List Action Event Payload:

{ "container": { "external": { "binding": { "address": ["external"] }, "type": "EVENT\_PAYLOAD\_BINDING" }, "fields": { "binding": { "address": ["fields"] }, "type": "EVENT\_PAYLOAD\_BINDING" }, "multiInstField": "sysId", "params": { "binding": { "address": ["params"] }, "type": "EVENT\_PAYLOAD\_BINDING" }, "passiveNavigation": { "binding": { "address": ["passiveNavigation"] }, "type": "EVENT\_PAYLOAD\_BINDING" }, "redirect": { "binding": { "address": ["redirect"] }, "type": "EVENT\_PAYLOAD\_BINDING" }, "route": { "binding": { "address": ["route"] }, "type": "EVENT\_PAYLOAD\_BINDING" }, "size": { "type": "JSON\_LITERAL", "value": "md" }, "title": { "binding": { "address": ["title"] }, "type": "EVENT\_PAYLOAD\_BINDING" } }, "type": "MAP\_CONTAINER" } ​

**3. Action Payload Definition**

**Table:** **sys\_declarative\_action\_payload\_definition**

- Configure the payload.
- **Route** should reference the **new page variant** that opens inside the dialog.

 

 

**4. UX App Route**

**Table:** **sys\_ux\_app\_route**

- **Parent Macrocomponent:** CSM/FSM Workspace – List Sys ID

 

**5. Action Configs**

**Table:** **sys\_ux\_action\_config**

- Add the created **Declarative Action** under **List Actions**.

 

**6. Page Variant Creation**

- Create a **Page Variant** at the **CSM/FSM Workspace** level.
- Add a **Form** component to the page.
- Configure **Data Resources → Form Controller**.

 

 

 


**Result**

- A custom **List Action button** appears in the CSM/FSM Workspace list.
- Clicking the button opens the configured **page variant in a dialog** with the form loaded.

 

View original source

https://www.servicenow.com/community/developer-articles/ui-builder-enhancement-create-new-button-list-with-popup/ta-p/3485404