Coveo Related Query

Warning
Legacy feature

This article pertains to the Coveo Hive framework which is now in maintenance mode.

Choose one of Coveo’s more modern, lightweight, and responsive libraries for any future search interface development. See the search interface Implementation guide for more details.

Implements the Coveo JavaScript Search Framework Recommendation component to get a result list related to the one executed in the main search interface.

The main purpose of the Coveo Related Query rendering is to execute a second query, slightly different from the current search interface query, which may take into account, or not, the current search interface filters in its advanced query expression (aq) and the current search interface query expression in its basic query expression (q).

Usage notes

Insertion location

Coveo Hive

The Coveo Related Query rendering is an Allowed Control in the following placeholder(s): Coveo UI, Recommendations.

Example insertion sequence for the Coveo Related Query rendering.

Coveo Hive SXA

Coveo for Sitecore SXA rendering insertion locations aren’t limited by placeholder Allowed Controls. The Coveo Related Query rendering may therefore be inserted throughout the partial design, whether in Coveo for Sitecore or Sitecore placeholders.

Example insertion sequence for the Coveo Related Query rendering.

Data source options

Option name Description

Main search interface

See the mainSearchInterface component option.

Use the search interface current filters

Adds advancedExpression to the optionsToUse component option values.

Use the search interface current query

Adds expression to the optionsToUse component option values.

Title

The text to show in the header.

Hide if no results

See the hideIfNoResults component option.

Filter results based on the current Sitecore context database

See the Sitecore Instance Filter rendering data source options.

Filter results on the current context language

See the Sitecore Instance Filter rendering data source options.

Filter results on the latest version

See the Sitecore Instance Filter rendering data source options.

Results per page

See the resultsPerPage component option.

Excerpt length

See the excerptLength component option.

Automatically trigger first query

See the autoTriggerQuery component option.

Hide until first query

See the hideUntilFirstQuery component option.

Enable history

See the enableHistory component option.

Custom CSS classes

See Insert Custom CSS.

Initialization file name

See Custom Initialization Scripts.

DOM unique ID

Randomly generated HTML element ID.

Additional data attributes

Allows use of the Coveo JavaScript Search Framework Recommendation component options that aren’t directly available in the data source.

Sample generated HTML and corresponding visual output

In the example below, the Use the search interface current query data source option is selected, and the Use the search interface current filters option isn’t selected.

<div id="coveoa061205e" class="CoveoRecommendation CoveoSearchInterface Coveostate
CoveoComponentState CoveoComponentOptions CoveoQueryController coveo-after-initialization
CoveoDebug" data-prebind-main-search-interface="mainSearchInterfaceSelector"
data-main-search-interface="#coveoC606340E" data-hide-if-no-results="false"
data-options-to-use="constantExpression,expression" data-results-per-page="5"
data-prebind-maximum-age="currentMaximumAge" data-title="Related Articles"
data-applied-prebind="true" data-maximum-age="0"
data-coveo-for-sitecore-event-registered="true">
Related Query Example | Coveo for Sitecore 5