SXA Coveo Facet Value Suggestions Rendering Item Overwriting Hive Item at Installation

This is for:

Developer System Administrator
In this article

Symptoms

When installing the Coveo for Sitecore SXA package, you get the following message:

Item being installed already exists in database.
ID:

Unknown macro: {33B7AEE1-AA35-40C1-BE1C-9029D5515CC9}
Path:
/sitecore/layout/Renderings/Coveo Hive/Search Box Components/Coveo Facet Value Suggestions
Please choose one of the following options:

As the message indicates, the item with an identical ID already in the database is the Coveo Hive Coveo Facet Value Suggestions rendering item. Hence, if you choose to overwrite this item, any Hive (non-SXA) search page that includes the Coveo Facet Value Suggestions rendering will break and display the following error:

Coveo Facet Value Suggestions.cshtml is a Sitecore Experience Accelerator rendering and can only be used on a page in an SXA site.

Cause

In the March 25, 2019 and April 18, 2019 releases, the Coveo for Sitecore SXA Coveo Facet Value Suggestions rendering item has the same ID as the Coveo Hive Coveo Facet Value Suggestions rendering item.

Resolution

Immediate Steps

If you have a Coveo Hive (non-SXA) search interface that includes a Coveo Facet Value Suggestions and you’re performing a fresh install of Coveo for Sitecore SXA, you can skip the item overwrite when prompted, or abort the installation altogether.

If you don’t have a Coveo Hive (non-SXA) search interface that includes a Coveo Facet Value Suggestions and you’re not planning to use the Coveo Facet Value Suggestions rendering in the near future, you can safely overwrite the Coveo Facet Value Suggestions.

If you have a Coveo Hive (non-SXA) search interface that includes a Coveo Facet Value Suggestions and you have already installed/upgraded Coveo for Sitecore SXA and overwritten the Coveo Hive (non-SXA) Coveo Facet Value Suggestions item, you should first remove the Coveo Facet Value Suggestions component from your search interface to eliminate the error message. The component is inserted in the Searchbox Components placeholder.

Final Steps

This issue is resolved in the May 17, 2019 release of Coveo for Sitecore. Upgrade Coveo for Sitecore and Coveo for Sitecore SXA to the May 17, 2019 release.