---
title: Replace the Service Portal search page
slug: '2105'
canonical_url: https://docs.coveo.com/en/2105/
collection: coveo-for-servicenow
source_format: adoc
---
# Replace the Service Portal search page
A Coveo-powered search page not only matches [keywords](https://docs.coveo.com/en/2738/) with [items](https://docs.coveo.com/en/210/), it also leverages [machine learning](https://docs.coveo.com/en/188/) and [Coveo Analytics](https://docs.coveo.com/en/182/) to ensure that the content returned to each user is the most relevant for them, based on their profile and inferred intentions.
A Coveo-powered search page also makes it possible for users to search many content [sources](https://docs.coveo.com/en/246/) at once, which typical search engines don't allow.
Therefore, to take full advantage of Coveo for ServiceNow and leverage Coveo's unique features to improve your users' search experience in your Service Portal, you should replace your Service Portal search page with a customizable Coveo hosted search page.

To replace your ServiceNow Service Portal search page with a Coveo-powered search page

. [Create and customize a Coveo hosted search page](#create-and-customize-a-coveo-hosted-search-page-for-your-servicenow-service-portal) for use in your ServiceNow Service Portal.

. [Replace your Service Portal search page](#replace-your-service-portal-search-page-with-a-coveo-powered-search-page) with a Coveo-powered search page.

## Create and customize a Coveo hosted search page for your ServiceNow Service Portal

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+:

.. In the [Coveo Administration Console](https://docs.coveo.com/en/183/), 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 **Add search page**.

.. [Create and customize the Coveo hosted search page](https://docs.coveo.com/en/na2g0545#create-a-search-page) using the **Simple builder**.

.. Once the hosted search page is created, 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, copy the **ID** of the search page, and paste it somewhere safe and accessible.
You'll need to enter it in the ServiceNow interface later.

* For versions of Coveo for ServiceNow prior to 25.1.5:

.. In the [Coveo Administration Console](https://docs.coveo.com/en/183/), 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 **Add search page**.

.. In the **Add a search page** screen, click **Legacy Interface Editor** to [create a legacy hosted search page](https://docs.coveo.com/en/1656#legacy-search-page).

> **Note**
>
> Take note of your search page name, as you'll need to enter it in the ServiceNow interface later.

.. Customize the legacy hosted search page using the [Interface Editor](https://docs.coveo.com/en/1852/).

## Replace your Service Portal search page with a Coveo-powered search page

. In the Now Platform UI of your ServiceNow instance, navigate to **Service Portal** > **Configuration**.

. Click **Designer**.

. Open the Service Portal search page you want to replace with a Coveo-powered search page.

> **Note**
>
> If you're using Page Route Maps (**Service Portal** > **Page Route Maps**), you must open the search page to which the redirect is routed.
> For example, if you redirect to `sp_search`, you must open the `sp_search` page.

. Delete all widgets and containers on the page, or reorganize them to make room for the Coveo search widget.

. Add a one-column container, or a two-column container to [display personalized recommendations](https://docs.coveo.com/en/2863/) next to the search results list.

**Example**

The Main Search and the [Recommendations](https://docs.coveo.com/en/2853#recommendations) widget in a two-column container:

![The Main Search and the Recommendations widget in a two-column container | Coveo for ServiceNow](https://docs.coveo.com/en/assets/images/coveo-for-servicenow/main-search-and-recommendations.png)

. Drag one of the following Coveo search page widgets inside the container.
The widget to use depends on whether you [created the Coveo search page](#create-and-customize-a-coveo-hosted-search-page-for-your-servicenow-service-portal) using the **Simple builder** or **Legacy Interface Editor**.

** **Coveo Atomic Search Page** (Coveo for ServiceNow 25.1.5+): Use this widget if you created your Coveo search page using the **Simple builder**.

** **Coveo Main Search**: Use this widget if you created your Coveo search page using the **Legacy Interface Editor**.

. At the upper-right corner of the Coveo search page widget, click ![Edit widget icon | Coveo for ServiceNow](coveo-for-servicenow/edit-widget-icon.png).

. Specify the widget options:

** For the [**Coveo Atomic Search Page** options](https://docs.coveo.com/en/2853#coveo-atomic-search-page-widget-options), in the **Search Page ID** field, enter the ID of your Coveo search page.

> **Note**
>
> You can find the **ID** of your Coveo hosted search page 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 of the [Coveo Administration Console](https://docs.coveo.com/en/183/).

** For the [**Coveo Main Search** options](https://docs.coveo.com/en/2853#coveo-main-search-widget-options), in the **Hosted Search Page** field, enter the name of your Coveo search page.

> **Note**
>
> You can find the **Name** of your Coveo hosted search page 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 of the [Coveo Administration Console](https://docs.coveo.com/en/183/).

. Optionally, specify other [widget options](https://docs.coveo.com/en/2853#search-page) as required.

**Examples**

* Use the **Scope** and **Component** options to name the widget according to your [naming convention](https://docs.coveo.com/en/3198#establish-a-widget-naming-convention).

* You can use the **CSS classes** option to [define page-specific CSS rules](https://docs.coveo.com/en/2852#customize-the-css-of-a-widget) to modify how the Coveo search page renders on the page, such as to adjust the vertical alignment of the widget.

. Click **Save** to save your widget options.

. For navigation purposes, you may also want to add a one-column container with a **breadcrumbs** widget above the container with Coveo search.

> **Note**
>
> To edit your Coveo-powered search page, 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 of the [Coveo Administration Console](https://docs.coveo.com/en/183/), click the search page, and then click **Edit** in the Action bar.

## Configure your query pipeline

Once you have implemented the widget in your ServiceNow instance, you must [link it to a query pipeline](https://docs.coveo.com/en/3198/) in your Coveo organization.

. On the [**Query Pipelines**](https://platform.cloud.coveo.com/admin/#/orgid/search/pipelines/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/search/pipelines/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/search/pipelines/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/search/pipelines/)) page of the [Coveo Administration Console](https://docs.coveo.com/en/183/), do one of the following:

** Click an existing pipeline, and then click **Edit components** in the Action bar.

** [Create a new pipeline](https://docs.coveo.com/en/1791#create-a-query-pipeline) for your Coveo for ServiceNow widget to use.

. In the query pipeline panel, [create a condition](https://docs.coveo.com/en/1959#create-a-condition) enforcing a specific search hub (`Search hub is`) for the pipeline.
The filter value to enter depends on your widget configuration:

** If you didn't provide [Scope and Component values](https://docs.coveo.com/en/3198#establish-a-widget-naming-convention) in the widget options, enter `ServiceNow`.

** If you provided a scope and a component, enter them in the following format: `Scope_Component`.

**Example**

For a widget with a `Portal` scope and a `MyWidget` component, your condition value should be `Portal_MyWidget`.
Your complete pipeline condition is therefore `Search Hub is Portal_MyWidget`.

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

> **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 a new portal widget to this pipeline, so your new condition is `Search Hub is Portal_MyWidget OR Search Hub is Portal_MySecondWidget`.
> With this condition, your pipeline will be used for all queries originating from one of these widgets.

## What's next?

[Replace the current search boxes in your Service Portal pages with standalone Coveo search boxes](https://docs.coveo.com/en/2106/) in order to properly forward [queries](https://docs.coveo.com/en/231/) to your Coveo-powered search page, and to eventually provide [Coveo Machine Learning (Coveo ML)](https://docs.coveo.com/en/188/) [query suggestions](https://docs.coveo.com/en/1015/) to your customers.