--- title: Search and listing configuration APIs deprecation slug: q4dd0300 canonical_url: https://docs.coveo.com/en/q4dd0300/ collection: deprecations source_format: adoc --- # Search and listing configuration APIs deprecation The legacy search and listing configuration APIs for creating and managing [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/) and query configurations are being deprecated. Going forward, PLPs must be created using the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/) or the [Public Listing Page API](https://docs.coveo.com/en/pbjb9139/), and query configurations for both search and listing pages must be managed through the [Query Configurations API](https://docs.coveo.com/en/pbbf0247/). All [Coveo organizations](https://docs.coveo.com/en/185/) using the legacy search or listing configuration APIs must migrate to the replacement APIs before the deprecation date. After this date, the legacy API endpoints will no longer be supported. ## Timeline [%header,cols="~,~"] |=== |Date |Milestone |October 1, 2025 |New implementations use the Public Listing Page API and Query Configurations API by default. |November 25, 2025 |Customer announcement. Existing rules and configurations are automatically migrated at the database level. |August 31, 2026 |Legacy search and listing configuration API endpoints are officially deprecated and no longer supported. |=== ## Scope Your [Coveo organization](https://docs.coveo.com/en/185/) is affected if it uses the legacy search or listing configuration APIs to create or manage PLPs or query configurations. This deprecation applies to the following Commerce API endpoints: * [Search configurations](https://docs.coveo.com/en/103/api-reference/commerce-api#tag/Search-Configurations) * [Listing configurations](https://docs.coveo.com/en/103/api-reference/commerce-api#tag/Listing-Configurations) To determine whether your [Coveo organization](https://docs.coveo.com/en/185/) is affected * You're using the legacy approach if your implementation creates or manages PLPs through the [legacy listing configurations](https://docs.coveo.com/en/o78c0306/) endpoints, or manages search and listing configurations through the [legacy search configurations](https://docs.coveo.com/en/o7mc0039/) and [legacy listing configurations](https://docs.coveo.com/en/o78c0306/) endpoints. * You're not affected if you already create PLPs exclusively through the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/) or the [Public Listing Page API](https://docs.coveo.com/en/pbjb9139/), and manage query configurations through the [Query Configurations API](https://docs.coveo.com/en/pbbf0247/). ## What happens after the deprecation date? After August 31, 2026: * The legacy search and listing configuration API endpoints will no longer be supported. * Any automation, scripts, or workflows that depend on the deprecated endpoints will stop functioning. To avoid disruption, complete the [required migration steps](#required-actions) before the deprecation date. ## Benefits of migrating Migrating to the Public Listing Page API and the Query Configurations API brings meaningful improvements to your Commerce experience: * **Merchandiser-friendly listing page creation.** Create and manage PLPs directly in the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/) with an intuitive interface, without requiring developer involvement or API calls. * **Bulk listing page creation.** Create multiple PLPs in a single API call using the [Create multiple listing pages](https://docs.coveo.com/en/103/api-reference/commerce-api#tag/Public-Listing-Page-API/operation/bulkCreate_1) endpoint, reducing the number of API calls needed for large catalog structures. * **Access to new CMH features.** Only organizations using the new APIs can access the latest [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/) capabilities. * **Continued investment.** Only the replacement APIs will receive future improvements and new capabilities. Migrating now means your [Coveo organization](https://docs.coveo.com/en/185/) benefits from ongoing Coveo investment. ## Required actions [Coveo organizations](https://docs.coveo.com/en/185/) using the legacy search or listing configuration APIs must complete the following migration steps before **August 31, 2026**. ### Step 1: Update product listing page integrations Your existing PLPs are automatically migrated at the database level. Update any automation, scripts, or workflows that create or manage PLPs to use the [Public Listing Page API](https://docs.coveo.com/en/pbjb9139/) or the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/) instead of the legacy endpoints. The new API separates page definition from merchandising rules and query configuration: * **Page-defining rules**: In the legacy API, page-defining filter rules were embedded as `filterRules` with `"essential": true`. In the new API, use the dedicated `pageRules` array to define a filter rule that determines which products appear on the page. * **Merchandising rules are managed separately.** The legacy API bundled ranking, pinning, and other merchandising rules directly in the listing configuration. With the new API, merchandising rules are managed through the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/) or dedicated endpoints, not as part of the page definition. * **Exclude rules are no longer page-defining rules.** In the legacy API, **Exclude** filter rules were allowed to define which products should not appear on a page. With the new API, **Exclude** filter rules can't be used as page-defining rules. If you were using **Exclude** filter rules as page-defining rules, review your existing configurations to determine how exclude rules should be handled. * **Query configuration is managed separately.** The legacy API allowed setting pagination, sorts, and facets as part of the listing configuration through `queryConfiguration`. With the new API, these settings are managed through the [Query Configurations API](https://docs.coveo.com/en/pbbf0247/) (see [step 2](#step-2-update-query-configuration-integrations)). ### Step 2: Update query configuration integrations Your existing query configurations are automatically migrated at the database level. Update any automation, scripts, or workflows that manage pagination, sorts, or product metadata to use the [Query Configurations API](https://docs.coveo.com/en/pbbf0247/) instead of the `queryConfiguration` property in the legacy endpoints. * For listing configurations, use the Query Configurations API with `solutionType` set to `listing`. * For search configurations, use the Query Configurations API with `solutionType` set to `search`. The legacy global endpoints remain backward compatible temporarily to facilitate migration, but you must migrate before the deprecation date. ### Step 3: Validate and remove legacy integrations After confirming that your PLPs work as expected with the new APIs: . Validate that PLPs appear correctly and that query configurations are applied as expected. . Remove any custom scripts, automation, or workflows that depend on the legacy API endpoints. > **Notes** > > * The new API behavior can be enabled on your development [Coveo organization](https://docs.coveo.com/en/185/) first by requesting an org-level feature flag, and then enabled in production. > Contact your Coveo representative to request the feature flag. > > * If your [Coveo organization](https://docs.coveo.com/en/185/) also uses legacy Commerce API facet configurations, consider migrating to the [Facet manager](https://docs.coveo.com/en/p63f0211/) at the same time. > See the [Legacy Commerce API facet management deprecation](https://docs.coveo.com/en/q3cc0299/) notice. ## Learn more * [Create product listing pages](https://docs.coveo.com/en/pbjb9139/) * [Use the Query Configurations API](https://docs.coveo.com/en/pbbf0247/) * [Create listing configurations (legacy)](https://docs.coveo.com/en/o78c0306/) * [Create search configurations (legacy)](https://docs.coveo.com/en/o7mc0039/) * [Legacy Commerce API facet management deprecation](https://docs.coveo.com/en/q3cc0299/) ## Get help If you have questions about the migration or need help, contact your Coveo representative.