--- title: Troubleshoot search implementation issues slug: '1650' canonical_url: https://docs.coveo.com/en/1650/ collection: coveo-analytics source_format: adoc --- # Troubleshoot search implementation issues The first time you deploy a search solution or after you make major changes to it, you may encounter issues that are difficult to identify using traditional quality assurance techniques. To detect these issues, you can monitor the [Coveo Analytics](https://docs.coveo.com/en/182/) after the search solution is live to ensure people are finding what they're looking for. **Example** Here are some typical issues you can find using Coveo Analytics: * Non-indexed items * Non-indexed item [fields](https://docs.coveo.com/en/200/) containing relevant text * Queries that don't return results * Search boxes which apply special filters that don't work as expected Coveo Analytics can help you ensure everything is working fine in a production environment. To troubleshoot search implementation issues with Coveo Analytics, you can use one or more of the following methods: * In the **Content Gaps** explorer: . On the [**Reports**](https://platform.cloud.coveo.com/admin/#/orgid/usage/reports/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/usage/reports/)) page of the [Coveo Administration Console](https://docs.coveo.com/en/183/), click the **Content Gaps** explorer, and then click **Open** in the Action bar. This explorer provides a list of queries that didn't return results (see [Content gaps](https://docs.coveo.com/en/1674#content-gaps)). . Investigate why each user query with the highest **Search Event Count** value didn't return results. > **Notes** > > * While it's normal to have search events without results because of typos or non-existing content, make sure that no queries for which you should expect results appear in the list. > > * A query might return results only for some users or in some interfaces because of permissions on items and hidden filters on queries used in some interfaces. . Determine whether the user query never returns results or if it only does so under certain patterns. **Example** The cards in this **Content Gap** explorer indicate that people aren't finding anything when they include the keyword `surftowel`. It might be that the item is identified by the term `surf towel` instead. To solve this issue, you can use a [thesaurus](https://docs.coveo.com/en/2742/) rule to establish a relation between the terms `surftowel` and `surf towel`. For more information on thesaurus rules, see [Manage thesaurus rules](https://docs.coveo.com/en/3405/). ![Content gaps dashboard showing graph of frequent queries without relevant results | Coveo](https://docs.coveo.com/en/assets/images/coveo-analytics/content-gaps-report.png) * In the **Search Relevance** explorer, do the following: . Take a sample of the top user queries that you feel should be followed by the most clicks by your users. . On the [**Reports**](https://platform.cloud.coveo.com/admin/#/orgid/usage/reports/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/usage/reports/)) page, click the **Search Relevance** explorer, and then click **Open** in the Action bar. . Add the **Click Event Count** [metric](https://docs.coveo.com/en/263/) to the table (see [Add dimensions or metrics to the data table](https://docs.coveo.com/en/1899#DimensionsMetricsAndFilters)). . Sort the table with descending **Click Event Count** metric values. . Verify that your top user queries are often followed by a click by your users. * In the **Summary** dashboard after updating your search solution: . On the [**Reports**](https://platform.cloud.coveo.com/admin/#/orgid/usage/reports/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/usage/reports/)) page, click the **Summary** dashboard, and then click **Open** in the Action bar. . Spot any abnormal changes in the data. In particular, the **Search Event Count** (number of reported queries), the **Average Click Rank Over Time** (in the **Relevancy** tab) and **[Search Event Clickthrough](https://docs.coveo.com/en/2837/) (%)** (in the **Relevancy** tab) metrics should remain stable. **Example** This metric card indicates that further investigations should be done if the drop in **Search Event Clickthrough (%)** around Nov 3rd matches one of the dates on which a search solution was updated: ![Line graph showing Click-Through Over Time | Coveo](https://docs.coveo.com/en/assets/images/coveo-analytics/metric-card-search-event-clickthrough.png) * Return to the **Search Relevance** explorer: . On the [**Reports**](https://platform.cloud.coveo.com/admin/#/orgid/usage/reports/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/usage/reports/)) page, click the **Search Relevance** explorer, and then click **Open** in the Action bar. . Remove the **User Query** [dimension](https://docs.coveo.com/en/258/) and **Visit Count** metric. . Add the [**Origin 1 (Page/Hub)**](https://docs.coveo.com/en/2948#origin-1-pagehub-formerly-search-hub) and [**Origin 2 (Tab/Interface)**](https://docs.coveo.com/en/2948#origin-2-tab-formerly-search-interface) dimensions to report the data by search interface. As each search interface may have different configurations (such as filters, ranking, query extensions, and more), checking the relevance metrics for each interface can help you identify invalid configurations. **Example** If you notice low search event counts (which is the case for the **CommunityCaseCreation** hub below) or unusual low **Search Event Clickthrough (%)** or **[Relevance Index](https://docs.coveo.com/en/2838/)**, there might be some configuration issues with this search interface. ![Search relevance analytics dashboard with graphs and metrics | Coveo](https://docs.coveo.com/en/assets/images/coveo-platform/search-relevance-dashboard.png)