Configure the built-in Coveo-powered search page

This is for:

In this article

Create and customize a Coveo hosted search page for ServiceNow
Link the Coveo-powered search page to a query pipeline
Required privileges
What’s next?

Coveo for ServiceNow comes with a built-in Coveo-powered search page that allows ServiceNow administrators to search their ServiceNow content as well as any other content that they choose to index in their Coveo organization.

Once configured in your ServiceNow instance, you can access Coveo’s built-in search page by navigating to Coveo > Search in ServiceNow.

To configure the built-in Coveo search page in your ServiceNow instance

Create and customize a Coveo hosted search page for use in your ServiceNow instance.
Link the Coveo hosted search page to a query pipeline.

Create and customize a Coveo hosted search page for ServiceNow

How you create and customize a Coveo hosted search page for ServiceNow depends on your version of Coveo for ServiceNow.

For Coveo for ServiceNow version 25.1.5+:
1. In the Coveo Administration Console, on the Search Pages (platform-ca | platform-eu | platform-au) page, click Add search page.
2. Create and customize the Coveo hosted search page using the Simple builder.
3. Once the hosted search page is created, on the Search Pages (platform-ca | platform-eu | platform-au) page, copy the ID of the search page.
4. In the Now Platform UI of your ServiceNow instance, navigate to Coveo > Properties.
5. In the Identifier of the Hosted Search Page to use for the full search page field, paste the ID of the search page.
6. Click Save.
For versions of Coveo for ServiceNow prior to 25.1.5:
1. In the Coveo Administration Console, on the Search Pages (platform-ca | platform-eu | platform-au) page, click Add search page.
2. In the Add a search page screen, click Legacy Interface Editor to create a legacy hosted search page, and name it ServiceNow_FullSearchPage.
3. Customize the legacy hosted search page using the Interface Editor.

Link the Coveo-powered search page to a query pipeline

Like the widgets you previously added to your ServiceNow instance, this built-in search page must be linked to a Coveo query pipeline in order to be operational.

In the Coveo Administration Console, on the Query Pipelines (platform-ca | platform-eu | platform-au) page:
- To use an existing pipeline, click the pipeline, and then click More > Edit in the Action bar.
- Create a new pipeline for the search page to use.

In the Add/Edit a Query Pipeline (platform-ca | platform-eu | platform-au) panel, create the following condition:

Search hub is ServiceNow_FullSearchPage.

With such a condition, your pipeline will be used for all queries originating from the search page.

Note

If your pipeline already has a condition, ensure to include this previous condition in your new one with an OR operator.

For example, your pipeline has the following condition: Search Hub is Portal_MyWidget. You want to link the built-in Coveo search page to this pipeline, so your new condition is Search Hub is Portal_MyWidget OR Search Hub is ServiceNow_FullSearchPage. With this condition, your pipeline will be used for all queries originating from either the widget or the search page.

Required privileges

The following table indicates the privileges required to configure a Coveo-powered search page and its associated query pipeline (see Manage privileges and Privilege reference).

Action	Service	Domain	Required access level
View search pages	Organization	Organization	View
Search	Search pages and IPX	View
Edit search pages	Organization	Organization	View
Search	Search pages and IPX	Edit
View query pipelines	Organization	Organization	View
Search	Query pipelines	View all
Edit query pipelines	Organization	Organization	View
Search	Query pipelines	Edit all

Action

Service

Domain

Required access level

View search pages

Organization

View

Search pages and IPX

View

Edit search pages

Organization

View

Search pages and IPX

Edit

View query pipelines

Organization

View

Query pipelines

View all

Edit query pipelines

Organization

View

Query pipelines

Edit all

What’s next?

If you implemented the Virtual Agent in your ServiceNow instance, see how you can Add the application to the Virtual Agent to help users find what they’re looking for.
Configure query filters to ensure that the Coveo for ServiceNow components you configured in your public-facing and internal portals only return items from appropriate subsets of your Coveo organization’s indexed content.