Integrate a Coveo hosted search page in an Experience Cloud site
Integrate a Coveo hosted search page in an Experience Cloud site
The Coveo Community Hosted Search Page component allows you to integrate a Coveo hosted search page in an Experience Cloud site. To create a hosted search page, you must use the Coveo search page builder, which is available in the Coveo Administration Console.
A Coveo hosted search page is a feature-rich search interface that’s easy to integrate. It’s also fully configurable using the Coveo search page builder, eliminating the need to make changes in Salesforce every time you want to modify an option.
Tip
The Coveo search page builder lets you create a simple search interface within a few minutes without writing any code. However, if you want to create a more advanced or a highly customized search interface, you should use the Quantic library instead. |
Prerequisites
-
Install and configure the Coveo for Salesforce v5.7 package or a later release.
-
Create a hosted search page with the Coveo search page builder.
-
Create a Salesforce Experience Cloud site.
ImportantThe Customer Service template is the only supported template.
-
Ensure that users have access to the
HSPController
Apex class.
Add the Community Hosted Search Page component
-
Access your Experience Cloud site using the Salesforce Experience Builder.
-
From the Pages menu in the top toolbar, select Search to access the search page.
-
From the Components panel on the left, under Custom Components, drag the Coveo Community Hosted Search Page component onto the page region where you want the search interface to appear, typically in the Content section replacing the Salesforce default search results component.
-
In the component details section on the right, click the Configuration name picklist to select the name of the hosted search page configuration you want to integrate. You should quickly see your search page render after selecting the configuration you want.
TipIf you’ve correctly configured the Coveo for Salesforce application, all the hosted search page configurations you created using the Coveo search page builder will be available in the picklist.
-
Under Engine ID, enter the ID of the engine instance the component must register to. Any string value can be specified.
ImportantAll components that belong to a given interface (for example, the Coveo Community Hosted Search Page and the Coveo Hosted Searchbox components) must use the same engine ID value to work properly.
-
(Optional) To hide the search box that’s integrated by default with the Coveo Community Hosted Search Page component, select the Hide integrated search box option.
NoteHiding the integrated search box is recommended if you plan to add a Coveo Hosted Searchbox in the header of your Experience Cloud site.
-
To preview your page, click Preview on the toolbar at the upper-right corner of the Experience Builder.
-
To publish your page, click Publish on the toolbar at the upper-right corner of the Experience Builder. This process make take a few minutes to complete.
The Coveo hosted search page is now available in your Experience Cloud site.
Current limitations
-
The Coveo Community Hosted Search Page component isn’t compatible with the Coveo Community SearchBox component.
To complement your hosted search page with a search box in the global header of your Experience Cloud site, you must use the Coveo Hosted Searchbox component.
-
The List layout is the only supported layout for search results.
-
English is the only language that’s supported by default for Coveo hosted search pages. Consider using the Salesforce Translation Workbench for your translation needs.
-
Custom context isn’t currently supported.