{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":5250,"path":"conversational-interfaces/virtual-agent/va-html-output.md","title":"HTML bot response control","bundle":null,"doc_type":null,"release":"australia","body":"\n# HTML bot response control\n\nUse the HTML bot response control to display static HTML text in the Virtual Agent bot response.\n\n**Note:** If you created conversations in earlier releases that use this bot response control to generate card layouts, consider updating your conversations to use the [Card bot response control](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-card-output.md). The Card displays information from a record in your instance and contains a link to that related record.\n\n## Security considerations for HTML markup\n\nFor security reasons, an HTML sanitizer script runs automatically and checks all HTML markup used in the instance, including Virtual Agent conversations. The sanitizer script removes elements or attributes that might enable cross-site scripting attacks. You can edit the HTML sanitizer script to change the list of markup items to be preserved or removed. For details, see [HTML sanitizer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-security/c_HTMLSanitizer.md). For examples of adding markup items to the exclusion or inclusion lists, see [Configure HTML sanitizer](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-security/t_ConfigureHTMLSanitizer.md).\n\nTo disable the HTML sanitizer script only for Virtual Agent conversations, add the **com.glide.cs.html.sanitizer.enabled** system property and set the value to false. For details about creating a system property, see [Add a system property](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/t_AddAPropertyUsingSysPropsList.md).\n\n## HTML bot response control properties\n\n<table id=\"table_il2_n2r_sdb\"><thead><tr><th>\n\nProperty\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nNode name\n\n</td><td>\n\nName that identifies this HTML bot response control node in the topic flow.\n\n</td></tr><tr><td>\n\nHTML message\n\n</td><td>\n\nHTML output to be displayed. Select the Script icon \\[Omitted image \"icon-script.png\"\\] Alt text: Script icon. to open the HTML editor and enter the HTML text.\n\n</td></tr><tr><td>\n\nHeight \\(Pixel\\)\n\n</td><td>\n\nMaximum height of the area for displaying HTML output in third-party messaging applications.\n\n</td></tr><tr><td>\n\nWidth \\(Pixel\\)\n\n</td><td>\n\nMaximum width of the bot bubble for displaying HTML output in third-party messaging applications.\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 show this node if\n\n</td><td>\n\nNo-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>## Channel support\n\n**Note:** As shown in the examples, HTML output can vary in third-party messaging applications. Determine an appropriate **Height** and **Width** area by setting initial height and width values, previewing the HTML output in the messaging applications you intend to use, and then adjusting the height and width values.\n\n|Channel|Support|Constraints|\n|-------|-------|-----------|\n|Web UI|Supported|None|\n|Mobile UI|Supported|None|\n|ServiceNow Otto panel|Supported|None|\n|Microsoft Teams|Supported|Since HTML is rendered as an image in Microsoft Teams, other controls are recommended. For example, use images or cards instead of HTML for Microsoft Teams.|\n|Slack|Supported|None|\n|Workplace|Supported|None|\n|Facebook Messenger|Not supported|Not applicable|\n|SMS Twilio|Not supported|Not applicable|\n|LINE|Not supported|Not applicable|\n|WhatsApp|Not supported|Not applicable|\n|Apple Messages for Business|Not supported|Not applicable|\n|Alexa \\(Voice\\)|Partial support|Supported on devices with screens. For nonscreen devices, the user receives a message: `We found a link`. For details, see [Fine-tune Virtual Agent settings and topics for the best Alexa voice chat experience](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-settings-for-alexa.md).|\n\n## Example HTML bot response output\n\nThe HTML bot response shows a static HTML as a chat response. This example includes an image, headings, and paragraph text. The web UI presents this content as HTML. The Slack, Microsoft Teams, and Workplace user interfaces display the same content as a PNG image. URL links within the HTML are extracted and displayed below the image. The URL can be either an absolute or a relative link. If you use a relative link, it must be relative to the ServiceNow instance.\n\n**Note:** Asset library controls may display and function differently in other channels.\n\n<table id=\"table_f1f_v2p_xdb\"><thead><tr><th>\n\nHTML bot response properties\n\n</th><th>\n\nHTML bot response output\n\n</th></tr></thead><tbody><tr><td>\n\n\\[Omitted image \"va-html-properties.png\"\\] Alt text: Basic properties include the node name, HTML message, height, and width.\n\n</td><td>\n\n\\[Omitted image \"va-html-native.png\"\\] Alt text: A chat window shows the company logo with a header, subheader, and body text.\n\n</td></tr></tbody>\n</table>**Parent Topic:**[Assistant Designer bot responses](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/conversational-interfaces/virtual-agent/va-bot-responses.md)\n\n"}}