---
sourceDocument: Australia Conversational Interfaces
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/conversational-interfaces

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australia Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Add a custom control to a topic or topic block

# Add a custom control to a Virtual Agent topic or topic block {#ariaid-title1}

* Freigeben Version: Australia
* 
* Aktualisiert 12. März 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Add a custom control to a Virtual Agent topic or topic block. During
the conversation, you can gather inputs from the user or display outputs to the
user.

## Vorbereitungen

Do the following before you start this task:

* [Create and publish the custom input
  or response control](https://servicenow-prod.fluidtopics.net/I6BBNeSyKcLz1exAhlXqzw "Build a custom input or response control that topic authors can use in topics or topic blocks. In Virtual Agent conversations, an input control gathers information from end users, while a response control displays information to end users.").
* Create a calling topic or topic block in which the custom control will be embedded.
{#embed-custom-control__ul_pdg_xq2_dmb}

Role required: virtual_agent_admin or admin

## Prozedur

1. Navigate to AllConversational InterfacesVirtual AgentDesigner.
2. On the home page, select the topic where you will add the custom control.
3. In the Flow tab, drag the Custom Control icon from the Utilities section of the palette to the appropriate position in the topic flow.  
   Hinweis:  
   If you selected Available on the palette in the custom control Properties page, the Custom Control displays as its own icon in the Utilities section of the palette.
4. Select the custom control node.
5. On the form, fill in the fields.  
   {#embed-custom-control__id_dst_y5v_1tb__entry__2}

   | Property | Description |
   |-|-|
   | Custom control | The name of a custom control asset that has been published in Virtual Agent Designer. |
   | Node name | The name of the custom control you selected. |
   | Input mapping | The variables to be used as input to the selected custom control. For example, the following image has example variables: The contents of this area change according to the custom control you selected. Options may include string input, referenced records, scripts, and so forth. |
   | Output mapping | The variables to be output by the selected custom control. For example, the following image has example variables that are enabled: The contents of this area change according to the custom control you selected. |
   | Advanced ||
   | Hide this node ||
   | Conditionally use this node if | A no-code condition statement or low-code script that specifies a condition for presenting this node in the conversation. The condition must evaluate to true. |
   [Tabelle : 1. Custom control utility properties sheet]

   {#embed-custom-control__id_dst_y5v_1tb}
6. Select Save.
7. To see how your custom control works in the topic, select Test in the header bar.  
   Your topic runs in a chat test window.
8. If no further changes are needed, select Publish in the Virtual Agent Designer header bar.
{#embed-custom-control__steps_pvw_zlv_2mb}

## Ergebnisse

The topic is active. You can deploy it to your Virtual Agent
clients.