{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":4948,"path":"conversational-interfaces/virtual-agent/embed-custom-control.md","title":"Add a custom control to a Virtual Agent topic or topic block","bundle":null,"doc_type":null,"release":"australia","body":"\n# Add a custom control to a Virtual Agent topic or topic block\n\nAdd 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.\n\n## Before you begin\n\nDo the following before you start this task:\n\n-   [Create and publish the custom input or response control](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/create-custom-control.md).\n-   Create a calling topic or topic block in which the custom control will be embedded.\n\nRole required: virtual\\_agent\\_admin or admin\n\n## Procedure\n\n1.  Navigate to **All** &gt; **Conversational Interfaces** &gt; **Assistant Designer**.\n\n2.  Select the **Asset library** tab.\n\n3.  Open the topic where you will add the custom control.\n\n4.  In the **Flow** tab, drag the Custom Control icon from the Utilities section of the palette to the appropriate position in the topic flow.\n\n    **Note:** 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.\n\n5.  Select the custom control node.\n\n6.  On the form, fill in the fields.\n\n<table id=\"id_dst_y5v_1tb\"><thead><tr><th>\n\nProperty\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nCustom control\n\n</td><td>\n\nThe name of a custom control asset that has been published in the Assistant Designer Asset library.\n\n</td></tr><tr><td>\n\nNode name\n\n</td><td>\n\nThe name of the custom control you selected.\n\n</td></tr><tr><td>\n\nInput mapping\n\n</td><td>\n\nThe variables to be used as input to the selected custom control. For example, the following image has example variables:\n\n \\[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.\n\n The contents of this area change according to the custom control you selected. Options may include string input, referenced records, scripts, and so forth.\n\n</td></tr><tr><td>\n\nOutput mapping\n\n</td><td>\n\nThe variables to be output by the selected custom control. For example, the following image has example variables that are enabled:\n\n \\[Omitted image \"cc-output-mapping-topic.png\"\\] Alt text: Output mapping variables for this custom control include issue and username.\n\n The contents of this area change according to the custom control you selected.\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nAdvanced\n\n</td></tr><tr><td class=\"sub-head\" colspan=\"2\">\n\nHide this node\n\n</td></tr><tr><td>\n\nConditionally use this node if\n\n</td><td>\n\nA 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.\n\n</td></tr></tbody>\n</table>7.  Select **Save**.\n\n8.  To see how your custom control works in the topic, select **Test** in the header bar.\n\n    Your topic runs in a chat test window.\n\n9.  If no further changes are needed, select **Publish** in the Assistant Designer Asset library header bar.\n\n\n## Result\n\nThe topic is active. You can deploy it to your Virtual Agent clients.\n\n"}}