---
sourceDocument: Australia Build or modify applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/application-development

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Create a UI interaction

# Create a UI interaction {#ariaid-title1}

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

Create a UI interaction and attach it to a component event in UI Builder. UI interactions are reusable flows that combine UI, logic, and scripts into a single unit, including custom UI built with Component Builder, and can be triggered from any component event on a
page.

## Antes de Iniciar

Role required: ui_builder_admin

## Por Que e Quando Desempenhar Esta Tarefa

In this task, you create a UI interaction and define its behavior using the diagram editor. You select an interaction type, add and configure steps, define logic and branching, and specify inputs that the interaction requires
at runtime.  
Importante:  
UI interactions don't run on their own. After creating an interaction, you must attach it to a component or page event so it can run when that event occurs.

## Procedimento

1. Navigate to AllNow Experience FrameworkUI Builder.
2. From the UI Builder home page, select CreateUI interaction.  
   Figura 1. Create UI interaction
3. In the creation modal, enter a name for the interaction.  
   For example, for a UI interaction to report a knowledge gap, you may enter <kbd class="ph userinput">Report Knowledge Gap</kbd>. You can change the name in the UI interaction settings later.
   Figura 2. UI interaction creation modal
4. Select an interaction Type.  
   Generic interactions are used with no dependencies on form or list controller data. Form interactions use form-specific steps such as validating or saving a record. List interactions use list-specific steps such as
   refreshing or querying a list.
5. **Opcional:** Enter a description that summarizes what the interaction does and when it runs.  
   For example, <kbd class="ph userinput">Displays a confirmation modal before deleting a record</kbd>.
6. Select Create.  
   Figura 3. UI interaction editor  
   The diagram editor opens with a start and end node connected by an add icon ![](). The steps available in the toolbox depend on the interaction type that you selected.
7. Build your interaction by selecting the add icon ![]() between the start and end nodes to add steps from the toolbox.
   1. Select + to open the toolbox.  
      Figura 4. UI interaction toolbox
   2. Browse the available steps by category, or search by name.
   3. Select a step to add it to the canvas.
   4. Configure the step properties in the configuration panel.
   5. Repeat to add additional steps in sequence.  
      To run steps in parallel, select the plus icon to add a parallel branch. Branches execute in order from top to bottom. To define conditional paths, add an If/Else step. Conditions can be defined using formula building or a script. Branches are evaluated top to bottom and the first branch that evaluates to true executes.
   6. If your interaction requires data at runtime, define inputs by selecting the Inputs pill and adding the data your interaction needs.  
      Supported input types are: String, True/False, Choice, Reference, and JSON.
   7. Select Save.
   8. **Opcional:** You can remove a step from the interaction at any time by selecting the delete icon ![]().
   {#create-ui-interaction-show-alert__substeps_wbf_pyg_d3c}

## Resultado

The UI interaction is created and ready to be attached to a component or page event. Once attached, it runs its configured steps whenever the specified event occurs. See [Trigger a UI interaction from a page event](https://servicenow-prod.fluidtopics.net/NEf0KCdxTUWu__96OdoTRg "Attach a UI interaction to a UI Builder page event so the interaction runs when a user performs an action on a component.").

To trigger this UI interaction from a form or list button using a declarative action, see [Trigger a UI interaction from a declarative action](https://www.servicenow.com/docs/access?context=configure-da-ui-interactions&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US).