---
sourceDocument: Australia ServiceNow AI Platform user interface
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/platform-user-interface

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia ServiceNow AI Platform user interface

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Create a UX add-on event mapping

# Create a UX add-on event mapping {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

Connect a button to a modal using UX add-on event mapping in order for an action button to open a custom modal.

## Antes de Iniciar

Complete the following actions:

* [Create a form action](https://servicenow-prod.fluidtopics.net/nMmTc_Xew4JO~LopDVoCtQ "Create a form action and add the button to a workspace.")
* Open your record page in UIB or [create a page variant in UIB](https://www.servicenow.com/docs/access?context=create-variant&version=australia&pubname=australia-application-development&ft:locale=en-US)
* [Design your page variant in UIB](https://servicenow-prod.fluidtopics.net/xHTQtAyUNdPhAyyq7eqXKQ#design-a-page-variant-in-uib "Configure a UI Builder page variant to pass from a workspace modal into the variant. This step acts as part of the process to configure an action button to open a custom modal.")
* [Configure your page variant as a modal in UIB](https://servicenow-prod.fluidtopics.net/n1qr~oSQXQgd9nBBHAfEDA#configure-a-page-variant-as-a-modal-in-uib "Define your page variant to appear as a modal using UI Builder configurations. This steps acts as part of the process to configure an action button to open a custom modal.")
{#create-a-ux-add-on-event-mapping__ul_gbv_jqm_d1c}

Role required: admin

## Procedimento

1. Open the add-on event mapping \<instance-name\>.service-now.com/sys_ux_addon_event_mapping_list.do into your browser.
2. Create a new record by selecting New.
3. Enter a name for your map.
4. Select ui_action_bar for the Source element ID field.
5. Select the action name for your declarative action for the Source Declarative Action field.
6. Set the macroponent to the workspace record macroponent using the sysID copied from the record's page definition.  
   For more information, see [Configure a page variant as a modal in UIB](https://servicenow-prod.fluidtopics.net/n1qr~oSQXQgd9nBBHAfEDA#configure-a-page-variant-as-a-modal-in-uib "Define your page variant to appear as a modal using UI Builder configurations. This steps acts as part of the process to configure an action button to open a custom modal.").
7. Trigger the event to open a modal by selecting \[Record Page\] Open modal in the Target Event field.
8. Define the fields to send to the modal by pasting the JSON object into the Target Payload Mapping field.  

       {
       	"type": "MAP_CONTAINER",
       	"container": {
       		"route": {
       			"type": "EVENT_PAYLOAD_BINDING",
       			"binding": {
       				"address": ["route"]
       			}
       		},
       		"size": {
       			"type": "EVENT_PAYLOAD_BINDING",
       			"binding": {
       				"address": ["size"]
       			}
       		},
       		"fields": {
       			"type": "EVENT_PAYLOAD_BINDING",
       			"binding": {
       				"address": ["fields"]
       			}
       		},
       		"params": {
       			"type": "EVENT_PAYLOAD_BINDING",
       			"binding": {
       				"address": ["params"]
       			}
       		}
       	}
       }

9. Select Submit.