Configure ServiceNow Otto button in search
Add a conversational chat button to standard catalog search results in mobile. The chat button redirects users to a new Virtual Agent conversation for eligible catalog items.
Before you begin
Role required: admin
Verify that ServiceNow Otto for AI Search and Otto Self Service Enhanced Chat are enabled for the catalog items you want to display the chat button on. See ServiceNow Otto for AI Search and Display your assistant on a portal, channel, or mobile app for more information.
Procedure
-
Navigate to the Template 05 card template record at sys_sg_view_template.do?sys_id=822e2f530f202010e70a4abec4767eee.
-
Open the Template JSON field for editing.
-
In the Children array of the root cell, add a new button object with the following mandatory fields:
Field Value Type "Button"Id "menu_01"CellId "menu_01"ContextMenu {"Presentation": "SearchMenu"}Here is an example of a JSON template with the mandatory fields added:
JSON{ "Type": "ViewGroup", "Margin": { "Top": 12, "Bottom": 12, "Right": 12, "Left": 12 }, "Orientation": "Horizontal", "Alignment": "Center", "Distribution": "Auto", "Id": "root", "CellId": "root", "Children": [ { "Type": "ViewGroup", "Id": "container_02", "Orientation": "Horizontal", "Alignment": "Center", "Distribution": "Auto", "CellId": "container_02", "Children": [ { "Type": "Image", "Id": "image_01", "Scaling": "Fill", "Height": 44, "Width": 44, "CellId": "image_01", "Margin": { "Right": 16 } }, { "Type": "ViewGroup", "Id": "container_03", "Margin": {}, "Orientation": "Vertical", "Alignment": "Left", "Distribution": "Equal", "CellId": "container_03", "Children": [ { "Type": "Text", "TextColor": "#151920", "TextColorVariable": "--now-color_text--primary", "MaxLines": 2, "CellId": "text_01", "Id": "text_01", "Margin": {}, "TextAlignment": "Left" }, { "Type": "Text", "TextColor": "#2C323F", "TextColorVariable": "--now-color_text--secondary", "MaxLines": 1, "Margin": { "Top": 8 }, "CellId": "text_02", "Id": "text_02", "TextAlignment": "Left" } ] } ] }, { "Type": "Button", "TextAlignment": "Center", "Id": "menu_01", "CellId": "menu_01", "ContextMenu": { "Presentation": "SearchMenu" }, "TextColorVariable": "--now-color--primary-1", "BorderColorVariable": "--now-color--primary-1", "BorderWidth": 0, "Height": 24, "Width": 24, "Margin": {} } ]} -
Select Save.
-
Navigate to the card template elements list (sys_sg_template_slot.list) and select New to create a new record.
-
Complete the following fields in the new card template element:
Field Value Name menu_01Type MenuCard template Template 05 -
Select Save.
-
Create three card template element attributes and associate them with the menu_01 card template element, using the following:
Attribute Type Description Value Attribute 1 AdditionalActionTypemenu_01_typeConversationAttribute 2 Iconmenu_01_icondbc96e63ff523210c63effffffffff8fAttribute 3 TextColorVariablemenu_01_TextColorVariable--now-color--primary-1
Parent Topic:Configuring Otto for Mobile
---
title: Configure ServiceNow Otto button in search
description: Add a conversational chat button to standard catalog search results in mobile. The chat button redirects users to a new Virtual Agent conversation for eligible catalog items.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/mobile/configure-now-assist-button-search.html
release: australia
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Configuring Otto, ServiceNow Otto for Mobile, Mobile Platform]
---
# Configure ServiceNow Otto button in search
Add a conversational chat button to standard catalog search results in mobile. The chat button redirects users to a new Virtual Agent conversation for eligible catalog items.
## Before you begin
Role required: admin
Verify that ServiceNow Otto for AI Search and Otto Self Service Enhanced Chat are enabled for the catalog items you want to display the chat button on. See [ServiceNow Otto for AI Search](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/now-assist-ais.md) and [Display your assistant on a portal, channel, or mobile app](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/conversational-interfaces/display-assistant-portal-channel.md) for more information.
## Procedure
1. Navigate to the Template 05 card template record at **sys\_sg\_view\_template.do?sys\_id=822e2f530f202010e70a4abec4767eee**.
2. Open the Template JSON field for editing.
3. In the Children array of the root cell, add a new button object with the following mandatory fields:
|Field|Value|
|-----|-----|
|Type|`"Button"`|
|Id|`"menu_01"`|
|CellId|`"menu_01"`|
|ContextMenu|`{"Presentation": "SearchMenu"}`|
Here is an example of a JSON template with the mandatory fields added:
```
{
"Type": "ViewGroup",
"Margin": {
"Top": 12,
"Bottom": 12,
"Right": 12,
"Left": 12
},
"Orientation": "Horizontal",
"Alignment": "Center",
"Distribution": "Auto",
"Id": "root",
"CellId": "root",
"Children": [
{
"Type": "ViewGroup",
"Id": "container_02",
"Orientation": "Horizontal",
"Alignment": "Center",
"Distribution": "Auto",
"CellId": "container_02",
"Children": [
{
"Type": "Image",
"Id": "image_01",
"Scaling": "Fill",
"Height": 44,
"Width": 44,
"CellId": "image_01",
"Margin": {
"Right": 16
}
},
{
"Type": "ViewGroup",
"Id": "container_03",
"Margin": {},
"Orientation": "Vertical",
"Alignment": "Left",
"Distribution": "Equal",
"CellId": "container_03",
"Children": [
{
"Type": "Text",
"TextColor": "#151920",
"TextColorVariable": "--now-color_text--primary",
"MaxLines": 2,
"CellId": "text_01",
"Id": "text_01",
"Margin": {},
"TextAlignment": "Left"
},
{
"Type": "Text",
"TextColor": "#2C323F",
"TextColorVariable": "--now-color_text--secondary",
"MaxLines": 1,
"Margin": {
"Top": 8
},
"CellId": "text_02",
"Id": "text_02",
"TextAlignment": "Left"
}
]
}
]
},
{
"Type": "Button",
"TextAlignment": "Center",
"Id": "menu_01",
"CellId": "menu_01",
"ContextMenu": {
"Presentation": "SearchMenu"
},
"TextColorVariable": "--now-color--primary-1",
"BorderColorVariable": "--now-color--primary-1",
"BorderWidth": 0,
"Height": 24,
"Width": 24,
"Margin": {}
}
]
}
```
4. Select **Save**.
5. Navigate to the card template elements list \(**sys\_sg\_template\_slot.list**\) and select **New** to create a new record.
6. Complete the following fields in the new card template element:
|Field|Value|
|-----|-----|
|Name|`menu_01`|
|Type|`Menu`|
|Card template|Template 05|
7. Select **Save**.
8. Create three card template element attributes and associate them with the menu\_01 card template element, using the following:
|Attribute|Type|Description|Value|
|---------|----|-----------|-----|
|Attribute 1|`AdditionalActionType`|`menu_01_type`|`Conversation`|
|Attribute 2|`Icon`|`menu_01_icon`|`dbc96e63ff523210c63effffffffff8f`|
|Attribute 3|`TextColorVariable`|`menu_01_TextColorVariable`|`--now-color--primary-1`|
**Parent Topic:**[Configuring Otto for Mobile](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/configuring-now-assist-mobile.md)
| title | Configure ServiceNow Otto button in search |
| description | Add a conversational chat button to standard catalog search results in mobile. The chat button redirects users to a new Virtual Agent conversation for eligible catalog items. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/mobile/configure-now-assist-button-search.html |
| release | australia |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | Configuring OttoServiceNow Otto for MobileMobile Platform |