Ensure that your search interfaces contain standard components

Coveo Relevance Cloud Developer System Administrator Product Documentation

This article lists the most common search interface components in a Coveo-powered implementation.

Important

This guide provides guidelines to analyze, review, and test different aspects of a Coveo-powered implementation.

It shouldn’t be considered an official, definitive guide to testing an implementation before it goes live, but rather a guide showcasing the basic components that Coveo implementations typically include.

Every Coveo implementation is different and may require custom configuration.

Therefore, you may notice discrepancies between the components and features listed in this guide and those you’re using in your actual implementation.

If you encounter issues, or have any questions related to this article, contact us for help.

Access your browser’s network monitoring tool

  1. Open your web browser’s developer tools.

    Note

    The examples in this article use the Google Chrome developer tools. For browser-specific information, see:

  2. Select the Network tab.

    Tip

    You can filter out irrelevant requests by selecting XHR on the Filter bar of the Network tab.

    Select XHR in the filter bar

Query suggestions

If your implementation leverages Coveo Machine Learning (Coveo ML) Query Suggestions (QS), make sure that your search interface contains the front-end component required to provide users with query suggestions.

Depending on the Coveo technology that you use to build your search interfaces, see:

To learn how to test the output provided by Coveo ML QS models, see:

Tabs

You can use tabs to separate the types of content you want to display into different sections of a search interface.

Depending on the Coveo technology that you use to build your search interfaces, see:

Test tabs

  1. Access the search interface in which you want to test tab behavior.

  2. Access your browser’s network monitoring tool.

  3. In the search interface, click a tab.

  4. In the network monitoring tool, under the Name column, select the latest request to the Search API. The request path should contain /rest/search/v2.

  5. Select the Payload tab. You should now see the request payload sent to the Search API.

  6. Under Form Data, find the cq property. The value of this property should correspond to the filters applied to scope the content of this tab.

    Test tabs in network monitoring tool | Coveo

Facets

Search interface facets let users refine their queries.

Coveo offers a large inventory of facet components to address the different ways in which users may want to refine their search results.

Depending on the Coveo technology that you use to build your search interfaces, see:

Test facets

  1. Access the search interface in which you want to test facet behavior.

  2. Access your browser’s network monitoring tool.

  3. Perform a query in the search box.

  4. In the network monitoring tool, under the Name column, select the latest request to the Search API. The request path should contain /rest/search/v2.

  5. Select the Preview tab.

  6. Find and expand the facets property. You should now see the facets that were returned for the query, along with the values available for each facet.

  7. Make sure that the returned facets and facet values are relevant, and that the facets use the correct fields as their input.

    Test facets in network monitoring tool | Coveo

Sorting

The sort component lets users select the criteria for sorting search results.

Depending on the Coveo technology that you use to build your search interfaces, see:

Test sorting

  1. Access the search interface in which you want to test sorting.

  2. Access your browser’s network monitoring tool.

  3. Perform a query in the search box.

  4. Make sure the intended sort options are rendered in the search interface.

    Sort drop-down rendered in the search interface | Coveo

  5. In the network monitoring tool, under the Name column, select the latest request to the Search API. The request path should contain /rest/search/v2.

  6. Select the Payload tab. You should now see the request payload sent to the Search API.

  7. Find the sortCriteria property and make sure that its value corresponds to the sort selection made in the search interface.

    Test sorting in network monitoring tool | Coveo

Result templates

Result templates determine the format search results are displayed in a search interface.

You should typically have one result template per item type.

Depending on the Coveo technology that you use to build your search interfaces, see:

Test result templates

For each result template, you should verify the following:

  • Links: Ensure that result template links redirect to the desired content.

    Tip
    Leading practice

    The result link result template component automatically transforms a search result title into a clickable link that points to the original item.

    Depending on the Coveo technology that you use to build your search interfaces, see:

  • Other information: Validate that all of the information displayed in the result template is correct and relevant.

Test result templates | Coveo

Quick view

An item quickview lets users preview the content of an item without having to open the search result. It consists of an HTML version of the item which is displayed in an iFrame that users can open through a result template.

Most Coveo source types automatically generate a quick view for each indexed item. However, some items may not have an HTML version indexed by Coveo, such as Database items or specific Salesforce objects (i.e., articles and cases).

Depending on the Coveo technology that you use to build your search interfaces, see:

Note

Coveo Atomic doesn’t currently support quick views out of the box.

Test quick views

Ensure that quick views load for each item type and that their content is appropriate for the intended audience.

  1. Access the search interface in which you want to test quick views.

  2. Perform a query in the search box.

  3. Click the Quick View button of the item you want to inspect.

  4. Ensure that the content of the item is properly displayed.

    Test quick views | Coveo

Recommendation component

If your implementation leverages Coveo ML Content Recommendations (CR), make sure that you have the required component to display the model’s output.

Depending on the Coveo technology that you use to build your search interfaces, see:

To learn how to test the output provided by Coveo ML CR models, see Test your CR model.

Did you mean

You will likely want to leverage the query correction feature to eliminate potential content gaps.

Depending on the Coveo technology that you use to build your search interfaces, see: