---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://www.servicenow.com/docs/r/application-development

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Configure an event handler manually

# Configure an event handler manually {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Add an event handler to a page, component, data resource, or declarative action
within UI Builder so that your user can trigger an action.

## Before you begin

Role required: ui_builder_admin

## About this task

An event handler lets you configure an action, components, data resource, or
declarative action on your page. For example, you can map an event to your page to
add an alert notification when the page successfully loads or you can add an event
handler for a button component to perform an action when a user clicks it. The event
handler could also be a modal on your page that asks a user to verify that the user
wants to delete the record. For more information, see [Manage actions in UI Builder pages](https://www.servicenow.com/docs/g8OZxPXUSQQN2_E5mYba5A "Learn how to work with events so that you can add actions to components, pages, data resources, and declarative actions in UI Builder.").  
Note:  
You can also use Now Assist in UI Builder to configure event handlers. For more, information, see [Configure an event handler with ServiceNow Otto](https://www.servicenow.com/docs/XXqr~2XN3TI8Rp3Qjo7D9g "Use ServiceNow Otto in UI Builder to configure event handlers. At present, you can configure Open page or URL, Open or close modal, and View load requested event handlers.")

## Procedure

1. Navigate to AllNow Experience FrameworkUI Builder.
2. Open an experience to work in or create an experience by selecting CreateExperience.  
   For more information, see [Configure how users interact with your applications in UI Builder](https://www.servicenow.com/docs/xRTj74jSaNpx1gbYEFN~zw "Learn what an experience is in UI Builder. Understand what an experience contains.").
3. Open or create a page.  
   For more information about how to create a page in UI Builder, see [Create a page
   in UI Builder](https://www.servicenow.com/docs/gGPA7eivyM0RFTMUEX~LWw "Create a page in UI Builder for a portal, workspace, or custom application so that you can build a web experience for your users.").
4. Add a component to your page, such as a button.  
   For more information about adding components to a page, see [Add and configure components](https://www.servicenow.com/docs/S25G6VJ3jD8Bu7gj_TwOLA#add-components "Learn how to add components to your page in UI Builder. A page is built by adding components.").
5. To add an event handler to your component's event, go to the configuration panel and select Events.  
   An event handler lets you assign an event to a component. For example, if you add a button component to your page, you want it to perform an action when a user clicks it.
6. To start the process of assigning an event to a component select Add event mapping.  
   Some components, such as the button component, only have one event mapping. Other components can have many events.
7. Select an event mapping that you want to configure from the list.
8. From the Event handler preview screen, select an action that you want assigned to the component.
9. Select Continue.
10. Select the handler you want to trigger from the event selected in the earlier step.  
11. Select Continue.
12. Configure the payload for the event.  
13. Select Add.
14. Select Save.
15. Test the event by selecting Preview in the header and trigger the action.

## Result

The configured event handler displays in the events tab of the configuration panel.

*[\>]: and then