--- title: Customize the Insight Panel slug: lbhe7179 canonical_url: https://docs.coveo.com/en/lbhe7179/ collection: coveo-for-servicenow source_format: adoc --- # Customize the Insight Panel > **Important** > > If you're using Coveo for ServiceNow v25.1.5+, we recommend using the Coveo Hosted Insight Panel to benefit from the latest features and improvements. > For more information, see [Integrate a Hosted Insight Panel](https://docs.coveo.com/en/oabf0454/). Once you've [implemented the Coveo Insight Panel](https://docs.coveo.com/en/2113#implement-the-insight-panel), you may want to perform one or more of the following additional configurations to enhance your workflow. ## Customize the Insight Panel search page By default, your Insight Panel uses a preconfigured search page. However, you can create a custom search page for each table in which you implemented the Insight Panel. The procedure to use depends on if you've implemented the Insight Panel in a [ServiceNow CSM Workspace](https://docs.coveo.com/en/2113#add-the-insight-panel-to-a-csm-workspace) or a [form in the standard ServiceNow interface](https://docs.coveo.com/en/2113#add-the-insight-panel-to-a-form-in-the-standard-servicenow-interface). ### Insight Panel in a ServiceNow CSM Workspace . Access the [**Search Pages**](https://platform.cloud.coveo.com/admin/#/orgid/search/search-pages/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/search/search-pages/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/search/search-pages/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/search/search-pages/)) page in the Coveo Administration Console. . [Create a legacy search page](https://docs.coveo.com/en/1656#create-a-hosted-search-interface). . [Use the Interface Editor](https://docs.coveo.com/en/1852/) to customize your new search interface. . If desired, in the Interface Editor, [enable the User Actions feature](https://docs.coveo.com/en/lbhe7179#enable-the-user-actions-feature-for-your-insight-panel-search-page) for your search page. . Assign the newly created search page to the Insight Panel implementation by entering the search page name in the [**Hosted Search Page ID**](https://docs.coveo.com/en/2113#searchPageIdconfig) field (CSM Configurable Workspace), or the [**searchPageId**](https://docs.coveo.com/en/2113#searchPageId) field (CSM Agent Workspace). ### Insight Panel in a form in the standard ServiceNow interface . Access the [**Search Pages**](https://platform.cloud.coveo.com/admin/#/orgid/search/search-pages/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/search/search-pages/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/search/search-pages/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/search/search-pages/)) page in the Coveo Administration Console. . [Create a legacy search page](https://docs.coveo.com/en/1656#create-a-hosted-search-interface), and name it `ClassicInsightPanel_`. Using this naming convention automatically assigns the search page to the Insight Panel in the specified table. **Example** * For an Insight Panel in the `sn_customerservice_case` table, the search page name must be `ClassicInsightPanel_sn_customerservice_case`. . Use the [Interface Editor](https://docs.coveo.com/en/1852/) to customize your new search interface. Your changes apply immediately. . If desired, in the Interface Editor, [enable the User Actions feature](https://docs.coveo.com/en/lbhe7179#enable-the-user-actions-feature-for-your-insight-panel-search-page) for your search page. ## Enable the User Actions feature for your Insight Panel search page The Insight Panel [User Actions](https://docs.coveo.com/en/2113#user-actions) feature lets agents see the items customers clicked and the terms they queried before they created the incident or case. To use the User Actions feature in a [custom search page](https://docs.coveo.com/en/lbhe7179#customize-the-insight-panel-search-page), you must enable the feature as follows: > **Note** > > The User Actions feature is enabled by default in the preconfigured default search page for the Insight Panel. . In the Coveo Administration Console, on the [**Search Pages**](https://platform.cloud.coveo.com/admin/#/orgid/search/search-pages/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/search/search-pages/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/search/search-pages/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/search/search-pages/)) page, click the desired page, and then click **Edit interface** in the Action bar. . Select the **Code View** tab. . Add the following component to the search page HTML template: ```html
``` . Click **Save**. Your changes apply immediately. ## Enable the Result Actions feature for your Insight Panel search page The [Result Actions](https://docs.coveo.com/en/2113#result-actions) feature lets agents quickly attach or copy search results directly from the Insight Panel. To use the Result Actions feature in a [custom search page](https://docs.coveo.com/en/lbhe7179#customize-the-insight-panel-search-page), you must enable the feature as follows: > **Note** > > The Result Actions feature is enabled by default in the preconfigured default search page for the Insight Panel. . In the Coveo Administration Console, on the [**Search Pages**](https://platform.cloud.coveo.com/admin/#/orgid/search/search-pages/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/search/search-pages/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/search/search-pages/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/search/search-pages/)) page, click the desired page, and then click **Edit interface** in the Action bar. . Select the **Code View** tab. . Add the following component to the search page HTML result template: ```html
``` . Click **Save**. Your changes apply immediately. ## About domain separation If you're customizing a form, you're likely working across different domains. Coveo therefore recommends reviewing the [FAQ section on domain separation](https://docs.coveo.com/en/2967#domain-separation). ## Display attached results in the Attached Knowledge table By default, the results attached by Coveo for ServiceNow don't show up in the `Attached Knowledge` table and are viewable only within the Insight Panel. To include attached knowledge base articles in the `Attached Knowledge` table, which allows the articles to be linked to cases and incidents, do the following: . In the Now Platform UI of your ServiceNow instance, navigate to **Coveo** > **Properties**. . Enable the knowledge article option. ![Coveo for ServiceNow knowledge article option](https://docs.coveo.com/en/assets/images/coveo-for-servicenow/coveo-for-servicenow-properties-knowledge-table.png) . Ensure that the `snsysid` property is present on the search results returned. If it's not, add `snsysid` in the `data-fields-to-include` parameter for the `CoveoResultList` template for your search page as follows: .. In the Coveo Administration Console, on the [**Search Pages**](https://platform.cloud.coveo.com/admin/#/orgid/search/search-pages/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/search/search-pages/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/search/search-pages/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/search/search-pages/)) page, click the desired page, and then click **Edit interface** in the Action bar. .. Select the **Code View** tab. .. Add `data-fields-to-include="@snsysid"` to the `CoveoResultList` template. ```html div class="CoveoResultList" data-layout="list" data-wait-animation="fade" data-auto-select-fields-to-include="true" data-fields-to-include="@snsysid" ``` . Click **Save**. . Reload the desired page to view the attached knowledge articles. ## Create a field blocklist By default, editing the content of any record form field triggers a [query](https://docs.coveo.com/en/231/) to Coveo, which in turn updates the Insight Panel. Moreover, the content of all form fields is sent as [context](https://docs.coveo.com/en/1345/) information for [Coveo Machine Learning (Coveo ML)](https://docs.coveo.com/en/188/) purposes. To avoid triggering a query when certain fields are edited frequently, contain irrelevant data, or if fields contain sensitive data that you don't want to send to Coveo, you can specify the fields to ignore. The procedure to use depends on if you've implemented the Insight Panel in a [ServiceNow CSM Workspace](https://docs.coveo.com/en/2113#add-the-insight-panel-to-a-csm-workspace) or a [form in the standard ServiceNow interface](https://docs.coveo.com/en/2113#add-the-insight-panel-to-a-form-in-the-standard-servicenow-interface). ### Insight Panel in the ServiceNow CSM Workspace Perform the following steps if you didn't specify fields to ignore when you implemented the Insight Panel, or to modify the list of fields to ignore. #### CSM Configurable Workspace . In the Now Platform UI of your ServiceNow instance, navigate to **Now Experience Framework** > [**UI Builder**](https://www.servicenow.com/docs/bundle/zurich-application-development/page/administer/ui-builder/concept/ui-builder-overview.html). . In the **My experiences** page of the UI Builder, click the workspace experience that contains the Insight Panel. . Ensure that the record page that contains the Insight Panel is selected in the page management panel. ![Workspace UI Builder Page](https://docs.coveo.com/en/assets/images/coveo-for-servicenow/servicenow-ui-builder-page.png) . In the content tree of the page management panel, select the **Coveo Agent Panel** component. . On the **Config** tab of the component configuration panel, specify the fields to ignore in the **fieldsToIgnore** field as comma-separated values. #### CSM Agent Workspace . In the Now Platform UI of your ServiceNow instance, navigate to **Workspace Experience** > **Actions & Components** > **Contextual Side Panel**. . On the **Action Assignments** page, open the action form that's associated with the Insight Panel. . Under **Related Links**, click **Advanced View**. . Specify the fields to ignore in the **fieldsToIgnore** field as comma-separated values. ### Insight Panel in a form in the standard ServiceNow interface [Create an extension using the `getFieldsToIgnore` function](https://docs.coveo.com/en/3227#getfieldstoignore-function) to specify the fields that shouldn't trigger queries and be sent to Coveo. ## Create a ServiceNow business rule for work notes You can create a [ServiceNow business rule](https://docs.coveo.com/en/l68a0318/) to automatically add a custom work note when a user attaches or detaches a Coveo search result in the Insight Panel. ## What's next? [Add the Page View Tracker widget to your portal pages](https://docs.coveo.com/en/3136/) as it's necessary to implement the Recommendations widget.