---
title: Manage the basic configuration of a query pipeline
slug: l1be0007
canonical_url: https://docs.coveo.com/en/l1be0007/
collection: tune-relevance
source_format: adoc
---
# Manage the basic configuration of a query pipeline
When you [create a query pipeline](https://docs.coveo.com/en/1791#create-a-query-pipeline) in the [Coveo Administration Console](https://docs.coveo.com/en/183/), you define its basic configuration such as its name, description, conditions, and more.
However, you can also manage this information after the pipeline has been created, if you decide to edit it.
The **Configuration** tab of a query pipeline allows members with the [required privileges](https://docs.coveo.com/en/l1be0007#required-privileges) to review and modify some basic information of an existing pipeline.

## Access the Configuration tab

To access the **Configuration** tab of a query pipeline:

. 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, click the desired query pipeline, and then click **Edit components** in the Action bar.

. On the page that opens, select the **Configuration** tab.

In this tab, you can:

* [Revise the pipeline name, description, use case, and project](#identification-section)

* [Manage the query pipeline's conditions](#condition-section)

* [Define the interface URLs served by the query pipeline](#interface-url-section)

* [Manage access to the query pipeline](#manage-query-pipeline-access)

## "Identification" section

In the **Identification** section, you can manage the following fields:

### "Pipeline name"

The query pipeline name is the one that appears 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 and can be renamed as needed.

. [Access the **Configuration** tab](#access-the-configuration-tab) of the query pipeline you want to manage.

. In the **Identification** section, in the **Pipeline name** input, you can change the name as needed.

. Click **Save**.

> **Important**
>
> When you rename a query pipeline that's used in production, first duplicate the pipeline and then rename it to ensure a smooth transition and to prevent any disruptions:
> 
> . [Duplicate the query pipeline](https://docs.coveo.com/en/1791#duplicate-a-query-pipeline) that you want to rename.
> 
> . Rename the duplicated pipeline.
> 
> . Update all query pipeline references in your configurations, API calls, search interfaces, and scripts to the new pipeline name.
> 
> . Test the renamed pipeline in the [**Content Browser**](https://platform.cloud.coveo.com/admin/#/orgid/content/browser/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/content/browser/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/content/browser/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/content/browser/)) to ensure it works correctly.
> 
> . Once you've ensured that the renamed pipeline works as expected, you can delete the original pipeline.

### "Description"

The description of a query pipeline can provide additional information about the pipeline's configuration, and you can add or edit it as needed.

. [Access the **Configuration** tab](#access-the-configuration-tab) of the query pipeline you want to manage.

. In the **Identification** section, in the **Description** input, add or edit the description.

. Click **Save**.

### "Use case"

Assigning a use case can help you categorize the query pipeline and identify its purpose.
This is useful when your Coveo organization has many query pipelines that serve different purposes.

. [Access the **Configuration** tab](#access-the-configuration-tab) of the query pipeline you want to manage.

. In the **Identification** section, in the **Use case** dropdown menu, select the desired value.
Available values are:

* **Ecommerce**

* **Service & Support**

* **Workplace**

* **Website**

. Click **Save**.

**Example**

In your Coveo [organization](https://docs.coveo.com/en/185/), you have the following query pipelines:

* **Insight-Panel-Pipeline**, that serves your support agent portal.

* **Barca-Commerce**, that serves your Coveo-powered commerce interface.

* **Barca-Intranet**, that serves your intranet's search interface.

To help Coveo administrators better manage and understand the purpose of each query pipeline, you categorize your query pipelines as follows:

[cols="2",options="header"]
|===
| Query pipeline name       | Use case
| **Insight-Panel-Pipeline**  | **Service & Support**
| **Barca-Commerce**          | **Ecommerce**
| **Barca-Intranet**          | **Workplace**
|===

### "Project"

The **Project** field is a dropdown menu that lets you associate the query pipeline with a project.
This is useful when you have a specific business scenario and you want to link the query pipeline to a project as one of its resources.

. [Access the **Configuration** tab](#access-the-configuration-tab) of the query pipeline you want to manage.

. In the **Identification** section, in the **Project** dropdown menu, select the desired project or click **Create a project** to [create a new one](https://docs.coveo.com/en/n7ef0517#add-or-edit-a-project).

. Click **Save**.

## "Condition" section

Once a query pipeline has been [created](https://docs.coveo.com/en/1791#create-a-query-pipeline), you can manage the query pipeline's associated [query pipeline conditions](https://docs.coveo.com/en/2793/) as needed.

. [Access the **Configuration** tab](#access-the-configuration-tab) of the query pipeline you want to manage.

. On the **Configuration** tab, under **Condition**, you can select a [condition](https://docs.coveo.com/en/2793/) in the dropdown menu or [create a new one](https://docs.coveo.com/en/1959#create-a-condition).
The query pipeline will apply to queries meeting this condition.

. Click **Save**.

## "Interface URL" section

The **Interface URL** section lets you enter the URL of the [search interfaces](https://docs.coveo.com/en/2741/) that use the query pipeline.
This is useful to quickly view and access the web pages for which search traffic is routed to the query pipeline.

. [Access the **Configuration** tab](#access-the-configuration-tab) of the query pipeline you want to manage.

. In the **Interface URL** section, enter the URLs of the search interfaces using the query pipeline.

. Click **Save**.

## Manage query pipeline access

Once a query pipeline has been [created](https://docs.coveo.com/en/1791#create-a-query-pipeline), you can edit the organization's [groups](https://docs.coveo.com/en/2867/) or API keys [level of access](https://docs.coveo.com/en/2818/) to this pipeline.

. [Access the **Configuration** tab](#access-the-configuration-tab) of the query pipeline you want to manage.

. On the **Configuration** tab, in the upper-right corner, click [dots] and then click **Manage access**.

. In the **Access Management** panel that opens, determine whether each group and API key can view or edit the query pipeline configuration:

** In the Access Level column, select **View** or **Edit** for each available group.

** On the left side of the panel, click **Groups** or **API Keys** to switch lists.

. In the **Access Management** panel, click **Save**.

. Back on the **Configuration** tab, click **Save**.

## Required privileges

The following table indicates the [privileges](https://docs.coveo.com/en/1791#required-privileges) required to view or edit the query pipelines page.
Learn more about the [Privilege reference](https://docs.coveo.com/en/1707/) or how to [manage privileges](https://docs.coveo.com/en/3151/).

[cols="3",options="header"]
|===
|Action
|Service - Domain
|Required access level

|View query pipeline basic configuration
|Organization - Organization  
Search - Query pipelines
|View

.2+|Edit query pipeline basic configuration
|Organization - Organization
|View

|Search - Query pipelines
|Edit
|===