Custom control utility

reference australia Updated Oct 24, 2026 1 min read va-custom-control-util.md

Use the Custom Control utility in a Virtual Agent topic or topic block to reference a custom input control or a custom response control. Custom controls complement the controls provided in Assistant Designer.

Custom control utility properties

Specify the properties of the custom input control or custom response control that you're adding to a topic or topic block. For more information about custom controls and their use, see Customizing Virtual Agent with custom controls.

[Omitted image "custom-control-utility-properties.png"] Alt text: Custom control utility properties sheet for an input control.

Note: Custom controls don't work on Internet Explorer version 11.

Property	Description
Custom control	The name of a custom control asset that has been published in the Assistant Designer Asset library.
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: [Omitted image "map-cc-input-values-topic-block.png"] Alt text: Input mapping variables on this custom control include transaction date and time, customer name, and product issue. 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: [Omitted image "cc-output-mapping-topic.png"] Alt text: Output mapping variables for this custom control include issue and username. 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.

**Parent Topic:**[Assistant Designer utilities](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-utilities.md)

94 lines · 3.3 KB Wrap lines

---
title: Custom control utility
description: Use the Custom Control utility in a Virtual Agent topic or topic block to reference a custom input control or a custom response control. Custom controls complement the controls provided in Assistant Designer.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/conversational-interfaces/virtual-agent/va-custom-control-util.html
release: australia
product: Virtual Agent
classification: virtual-agent
topic_type: reference
last_updated: "2026-10-24"
reading_time_minutes: 1
breadcrumb: [Assistant Designer utilities, Assistant Designer interface reference, Reference, Virtual Agent, Conversational Interfaces]
---

# Custom control utility

Use the Custom Control utility in a Virtual Agent topic or topic block to reference a custom input control or a custom response control. Custom controls complement the controls provided in Assistant Designer.

## Custom control utility properties

Specify the properties of the custom input control or custom response control that you're adding to a topic or topic block. For more information about custom controls and their use, see [Customizing Virtual Agent with custom controls](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/custom-controls.md).

\[Omitted image "custom-control-utility-properties.png"\] Alt text: Custom control utility properties sheet for an input control.

**Note:** Custom controls don't work on Internet Explorer version 11.

<table id="id_dst_y5v_1tb"><thead><tr><th>

Property

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Custom control

</td><td>

The name of a custom control asset that has been published in the Assistant Designer Asset library.

</td></tr><tr><td>

Node name

</td><td>

The name of the custom control you selected.

</td></tr><tr><td>

Input mapping

</td><td>

The variables to be used as input to the selected custom control. For example, the following image has example variables:

 \[Omitted image "map-cc-input-values-topic-block.png"\] Alt text: Input mapping variables on this custom control include transaction date and time, customer name, and product issue.

 The contents of this area change according to the custom control you selected. Options may include string input, referenced records, scripts, and so forth.

</td></tr><tr><td>

Output mapping

</td><td>

The variables to be output by the selected custom control. For example, the following image has example variables that are enabled:

 \[Omitted image "cc-output-mapping-topic.png"\] Alt text: Output mapping variables for this custom control include issue and username.

 The contents of this area change according to the custom control you selected.

</td></tr><tr><td class="sub-head" colspan="2">

Advanced

</td></tr><tr><td class="sub-head" colspan="2">

Hide this node

</td></tr><tr><td>

Conditionally use this node if

</td><td>

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.

</td></tr></tbody>
</table>**Parent Topic:**[Assistant Designer utilities](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-utilities.md)