Bind an event to a data resource
Assign event handlers within UI Builder to individual data resources on your page. When a data resource successfully fetches new data, it executes an event handler to take a user to the next step in a flow.
Before you begin
Role required: ui_builder_admin
About this task
Bind an event to a data resource, to perform data-related actions on your page. For example, you can add a button to reload data to a page if it doesn't load the first time. You can also set up a data resource event to reload data behind the scenes of your page.
Procedure
-
Navigate to All > Now Experience Framework > UI Builder.
-
Open an experience to work in or create an experience by selecting Create > Experience.
For more information, see Configure how users interact with your applications in UI Builder.
-
Create or open a page.
For more information about how to create a page in UI Builder, see Create a page in UI Builder.
-
If you do not have any components on your page, add one to your page.
For more information, see Add and configure components.
-
Add a data resource to your page.
For more information, see Add and configure data resources to a page.
-
Select a data resource instance.
[Omitted image "data-resource-select-look-record.png"] Alt text: Arrow pointing to the look up a single record data resource.
-
To add an event handler to your data resource, select the Events tab in the configuration panel of the data resource.
You can add event handlers to your data resource to handle actions for Operation Initiated, Operation Succeeded, and Operation Failed.
[Omitted image "data-resource-events.png"] Alt text: Events tab in data resources panel.
-
Select Add event mapping.
-
Select an event from the list.
[Omitted image "data-resource-events-list.png"] Alt text: List of events that can be bound to data resources.
-
Select Continue.
-
Select an event handler from the list.
[Omitted image "data-resource-event-handler-list.png"] Alt text: List of event handlers that can be assigned to an event.
-
Select Continue.
-
Fill in the required information for the event handler.
The configuration varies depending on which event handler is selected.
-
Select Add.
-
Select Save.
-
To preview your page and test the data resource event that you set up, select [Omitted image "preview-button.png"] Alt text: Preview button in the UI Builder header.
- Link an event to another page
Add a link to the destination event handler within UI Builder so that an event action can open another page. You can also configure the event handler to follow the App Route to the desired page.
Parent Topic:Bind events to add actions
---
title: Bind an event to a data resource
description: Assign event handlers within UI Builder to individual data resources on your page. When a data resource successfully fetches new data, it executes an event handler to take a user to the next step in a flow.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/application-development/ui-builder/bind-event-data-resource.html
release: brazil
product: UI Builder
classification: ui-builder
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 2
breadcrumb: [Bind events to add actions, Manage actions in UI Builder pages, Working in UI Builder, UI Builder, Builder library, Developing your application, Classic app development, Building applications]
---
# Bind an event to a data resource
Assign event handlers within UI Builder to individual data resources on your page. When a data resource successfully fetches new data, it executes an event handler to take a user to the next step in a flow.
## Before you begin
Role required: ui\_builder\_admin
## About this task
Bind an event to a data resource, to perform data-related actions on your page. For example, you can add a button to reload data to a page if it doesn't load the first time. You can also set up a data resource event to reload data behind the scenes of your page.
## Procedure
1. Navigate to **All** > **Now Experience Framework** > **UI Builder**.
2. Open an experience to work in or create an experience by selecting **Create** > **Experience**.
For more information, see [Configure how users interact with your applications in UI Builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/ui-builder/work-experiences.md).
3. Create or open a page.
For more information about how to create a page in UI Builder, see [Create a page in UI Builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/ui-builder/create-page.md).
4. If you do not have any components on your page, add one to your page.
For more information, see [Add and configure components](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/ui-builder/add-components.md).
5. Add a data resource to your page.
For more information, see [Add and configure data resources to a page](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/ui-builder/add-data-resources.md).
6. Select a data resource instance.
\[Omitted image "data-resource-select-look-record.png"\] Alt text: Arrow pointing to the look up a single record data resource.
7. To add an event handler to your data resource, select the **Events** tab in the configuration panel of the data resource.
You can add event handlers to your data resource to handle actions for Operation Initiated, Operation Succeeded, and Operation Failed.
\[Omitted image "data-resource-events.png"\] Alt text: Events tab in data resources panel.
8. Select **Add event mapping**.
9. Select an event from the list.
\[Omitted image "data-resource-events-list.png"\] Alt text: List of events that can be bound to data resources.
10. Select **Continue**.
11. Select an event handler from the list.
\[Omitted image "data-resource-event-handler-list.png"\] Alt text: List of event handlers that can be assigned to an event.
12. Select **Continue**.
13. Fill in the required information for the event handler.
The configuration varies depending on which event handler is selected.
14. Select **Add**.
15. Select **Save**.
16. To preview your page and test the data resource event that you set up, select \[Omitted image "preview-button.png"\] Alt text: Preview button in the UI Builder header.
- **[Link an event to another page](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/ui-builder/link-component-destination.md)**
Add a link to the destination event handler within UI Builder so that an event action can open another page. You can also configure the event handler to follow the App Route to the desired page.
**Parent Topic:**[Bind events to add actions](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/application-development/ui-builder/bind-events.md)
| title | Bind an event to a data resource |
| description | Assign event handlers within UI Builder to individual data resources on your page. When a data resource successfully fetches new data, it executes an event handler to take a user to the next step in a flow. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/application-development/ui-builder/bind-event-data-resource.html |
| release | brazil |
| product | UI Builder |
| classification | ui-builder |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 2 |
| breadcrumb | Bind events to add actionsManage actions in UI Builder pagesWorking in UI BuilderUI BuilderBuilder libraryDeveloping your applicationClassic app developmentBuilding applications |