Trigger a UI interaction from a page event

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

    • Attach a UI interaction to a UI Builder page event so the interaction runs when a user performs an action on a component.

    Before you begin

    You have already created a UI interaction that you want to trigger.

    Role required: ui_builder_admin

    About this task

    UI interactions don’t run on their own. To execute an interaction, you must attach it to an event that occurs on a page or component. UI interactions are triggered by page events, including events mapped from component actions.

    In this task, you configure a component event on a page to trigger an existing UI interaction.

    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 within the experience.
      For more information about how to create a page in UI Builder, see Create a page in UI Builder.
    4. Select the component that should trigger the interaction.
      If the page doesn’t already include the component you want to use, add it to the page first. For more information about adding components to a page, see Add and configure components.
    5. In the component configuration panel, select the Events tab.
      Figure 1. Events tab
      Button selected on a page, with Events tab displayed.
    6. Select Add handler.
    7. Search for your UI interaction by name, or select the UI interactions pill to filter results.
    8. Select the UI interaction that you want to trigger.
      Note:
      If your interaction type is Form or List and the applicable controller isn’t already on the page, it is added automatically. If multiple controllers exist on the page, you’re prompted to choose which one feeds data to the interaction.
      Figure 2. Add handler modal
      Add handler modal with UI interaction selected.
    9. Select Add.
    10. Select Save.
    11. Select Preview, then perform the action that fires the configured event to verify the interaction runs.

    Result

    When the specified page event occurs, the UI interaction runs and executes its configured actions.