Build a Hosted Insight Panel Interface
Build a Hosted Insight Panel Interface
The Coveo Insight Panel Builder is an intuitive tool designed to let you build Insight Panels without writing any code. The interfaces built using the Insight Panel Builder can be deployed to popular Customer Relationship Management (CRM) systems such as Salesforce.

The Insight Panel Builder is available once you’ve created an Insight Panel configuration. It’s accessible via the Insight Panel (platform-ca | platform-eu | platform-au) page of the Coveo Administration Console, and relies on Coveo’s latest UI framework, Coveo Headless, which supports both the Coveo Quantic (Salesforce only) and Coveo Atomic libraries.
Insight Panel Builder Features
Result Templates
Result templates set how individual query results appear in the Hosted Insight Panel based on certain conditions. For example, you can display PDF and Web results differently. The Search results display panel lets you create result templates, configure display options, and enable or disable result actions and tags (see Configure Result Templates).
Filtering Options
The Filtering options panel lets you configure navigation components such as facets and tabs quickly and easily (see Configure Filtering Options).
Settings
The Settings panel lets you access the Hosted Insight Panel’s configuration ID, as well as enable or disable key features such as Insight Full Search (see Configure Settings).
Access the Insight Panel Builder
-
On the Insight Panel (platform-ca | platform-eu | platform-au) page, click the Insight Panel configuration you want to edit, and then click Edit in the Action bar.
-
Under Insight Panel Builder, click Edit interface.
|
Note
The Insight Panel Builder is also accessible when adding an Insight Panel configuration. |
Configure Result Templates
The Search results display panel of the Insight Panel Builder lets you perform the following tasks:
Add Result Templates
-
Click Search results display.
-
In the Result templates section, click Add template.
-
In the Name field, enter a name to recognize and edit your template later.
-
Under Usage, click Add condition to determine when to use this result template.
Notes-
A minimum of one condition is required.
-
For each query result, the Hosted Insight Panel evaluates the condition(s) to determine which result template to use.
-
In the Select a field dropdown menu, select the desired field (e.g.,
source
). -
In the Select a condition dropdown menu, select the desired operator (e.g.,
Must match
). -
In the Values field, specify at least one value (e.g.,
YouTube
).TipUse a comma-separated list to specify multiple values.
-
Click Done to apply your changes.
-
-
Under Colored badge, set the following options:
-
Click On or Off to enable or disable badges, respectively.
-
Select a field to display as a colored badge at the top of your result template. This visual cue helps users quickly recognize a result type such as a document or a video.
For example:
TipStart typing a Coveo field name in the dropdown menu to filter by name, and then select the desired field.
-
Select a color for your badge.
-
-
Under Additional information, click Add details.
-
Select a field to display the related metadata value at the bottom of your result template.
For example:
TipStart typing a Coveo field name in the dropdown menu to filter by name, and then select the desired field.
-
(Optional) To include a label for the selected field, select the Include label checkbox. You can enter a custom label name or keep the default field name.
NoteClear the Include label checkbox if you don’t want to include a label for the field.
-
Click Done to apply your changes.
-
Repeat this step to display additional details (e.g.,
author
,type
, andduration
).
-
-
Click Save to save your result template.
-
Click Done to return to the Search results display panel.
Edit Result Templates
-
Click Search results display.
-
In the Result templates section, click the card of the result template you want to edit.
-
Modify the settings in the following sections, as appropriate:
-
Note
The name of the Default result template can’t be modified.
-
-
Click Save to save your changes.
Delete Result Templates
-
Click Search results display.
-
In the Result templates section, click the result template you want to delete.
-
Click Delete.
-
Click Delete again to confirm the action.
-
Click Save.
Reorder Result Templates
-
Click Search results display.
-
In the Result templates section, click
on the template card to drag and drop it in the desired order.
Notes-
The Default template can’t be reordered.
-
Result templates are evaluated in the order they appear in the list. This means that if a query result meets the conditions found in multiple templates, the Hosted Insight Panel will render the result using the first applicable template in the list.
-
-
Click Save to apply your changes.
Enable or Disable Result Actions
|
Note
Although the Attach to case, Copy to clipboard, and Quick view result actions are enabled by default, they aren’t currently available in the Builder preview. These functionalities can only be leveraged in your CRM system (see About Result Actions). |
-
Click Search results display.
-
To enable or disable the Attach to case, Copy to clipboard, or Quick view result actions, select or clear the corresponding checkbox under Result actions.
Enable or Disable Tags
|
Note
The Recommended tag is disabled by default. |
-
Click Search results display.
-
To enable or disable the Recommended tag, select or clear the corresponding checkbox under Tags.
NoteTags can’t be set on specific result templates. This setting applies to all result templates (i.e., existing and newly created ones).
Configure Filtering Options
The Filtering options panel of the Insight Panel Builder lets you manage the following functionalities:
Manage Facets
The Facets section of the Filtering options panel lets you perform the following tasks:
Enable or Disable Facets
|
Note
The Source, Author, and Item type facets are enabled by default. |
-
Click Filtering options.
-
To enable or disable all facets, click On or Off respectively in the Facets section.
ImportantSaving the Insight Panel Builder configuration after disabling facets deletes the existing facet configurations. Although you will be able to add new facets after reloading the page, the previous ones will no longer exist.
-
Click Save.
Add Facets
-
Click Filtering options.
-
In the Facets section, click Add facet.
-
In the Select a field dropdown list, select a facet field (e.g.,
year
oritemtype
).TipStart typing a Coveo field name in the dropdown menu to filter by name, and then select the desired field.
-
In the Display section, select one of the following options:
-
Checkbox to display a checkbox next to the field values.
-
Link to display the field values as links.
-
-
Click Done to apply your changes.
-
Click Save.
Edit Facets
Delete Facets
-
Click Filtering options.
-
In the Facets section, expand the facet card you want to delete.
-
Click the Trash icon button to delete the facet.
-
Click Save.
Manage Tabs
The Tabs section of the Filtering options panel lets you perform the following tasks:
Enable or Disable Tabs
|
Note
Tabs are disabled by default. |
-
Click Filtering options.
-
To enable or disable all tabs, click On or Off respectively in the Tabs section.
NoteThe All tab can’t be deleted and is provided by default to ensure all content can be viewed.
-
Click Save.
Add Tabs
-
Click Filtering options.
-
In the Tabs section, click Add tab.
-
In the Label field, enter the name that will be displayed on the tab in the Insight Panel.
-
Under Usage, click Add condition to determine the content that will be part of this tab.
-
In the Select a field dropdown menu, select the desired field (e.g.,
source
).TipStart typing a Coveo field name in the dropdown menu to filter by name, and then select the desired field.
-
In the Select a condition dropdown menu, select the desired operator (e.g.,
Must match
). -
In the Values field, specify at least one value (e.g.,
YouTube
).TipTo specify multiple values, use a comma to separate each value.
-
-
Click Done to apply your changes.
-
Click Save.
Edit Tabs
Delete Tabs
-
Click Filtering options.
-
In the Tabs section, click the tab card you want to delete.
-
In the panel that opens, click Delete to delete the tab.
NoteThe All tab can’t be deleted.
-
Click Delete again to confirm your changes.
-
Click Save.
Reorder Tabs
-
Click Filtering options.
-
In the Tabs section, click
on the Tabs card, and then drag and drop the card in the desired order.
NoteThe All tab can’t be reordered. It will always appear at the top of the Tabs list since it’s meant to display all content.
-
Click Save to apply your changes.
Configure Settings
The Settings panel of the Insight Panel Builder lets you perform the following tasks:
Access the Hosted Insight Panel Configuration ID
-
Click Settings.
-
Under Configuration ID, click
to copy the Hosted Insight Panel configuration ID to your clipboard.
Enable or Disable the Insight Full Search Functionality
|
Note
Although the Insight Full Search functionality is enabled by default, it’s not currently available in the Builder preview. This functionality can only be leveraged in your CRM system (see Activate the Insight Full Search Functionality). |
-
Click Settings.
-
To enable or disable the Insight Full Search functionality, select or clear the Full Search checkbox under Insight Panel features.
-
Click Save to apply your changes.
What’s Next
Learn how to integrate your Hosted Insight Panel in Salesforce (see Integrate a Coveo Quantic Insight Panel Component).