Bind an event to a data resource

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read

    • 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.
    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.
    4. Optional: If you do not have any components on your page, add one to your page.
      For more information, see Add and configure components.
    5. Add a data resource to your page.
      For more information, see Add and configure data resources to a page.
    6. Select a data resource instance.
      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.

      Events tab in data resources panel.
    8. Select Add event mapping.
    9. Select an event from the list.
      List of events that can be bound to data resources.
    10. Select Continue.
    11. Select an event handler from the list.
      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 Preview button in the UI Builder header.