---
title: QuanticRecommendationList
slug: latest-recommendation-recommendation-list
canonical_url: https://docs.coveo.com/en/quantic/latest/reference/recommendation-components/recommendation-recommendation-list/
collection: quantic
source_format: adoc
---
# QuanticRecommendationList

> **Note**
>
> This component was introduced in version `2.26.0`.

The `QuanticRecommendationList` component displays recommendations by applying one or more result templates in different layouts.

## Example

```html
<c-quantic-recommendation-list engine-id={engineId} recommendation={recommendationId} fields-to-include="objecttype,filetype" number-of-recommendations="3" recommendations-per-row="10" heading-level="1"></c-quantic-recommendation-list>
```

## Properties

--
|===
| Property | Attribute | Description | Type | Default

| `engineId` _(required)_
| `engine-id`
a| The ID of the engine instance the component registers to.
| `string`
|

| `recommendation`
| `recommendation`
a| The recommendation identifier used by the Coveo platform to retrieve recommended documents.
| `string`
| `{'recommendation'}`

| `numberOfRecommendations`
| `number-of-recommendations`
a| The total number of recommendations to fetch.
| `number`
| `{10}`

| `fieldsToInclude`
| `fields-to-include`
a| A list of fields to include in the query results, separated by commas.
| `string`
| `'date,author,source,language,filetype,parents,sfknowledgearticleid,sfid,sfkbid,sfkavid'`

| `label`
| `label`
a| The label of the component. This label is displayed in the component header.
| `string`
| `'Top documents for you'`

| `headingLevel`
| `heading-level`
a| The Heading level to use for the heading label, accepted values are integers from 1 to 6.
| `number`
| `{3}`

| `variant` _(required)_
| `variant`
a| The variant of the component. Accepted variants are `grid` and `carousel`.
| `'grid', 'carousel'`
|

| `recommendationsPerRow`
| `recommendations-per-row`
a| The number of recommendations to display, per row.
Each recommendation in the row will be displayed as
1/recommendationsPerRow of the container width.
| `number`
| `{3}`

|===
--

## Custom events

The component fires the following custom event:

* `quantic__registerrecommendationtemplates`

## XML configuration file elements

The following XML configuration file elements apply (see [XML Configuration File Elements](https://developer.salesforce.com/docs/component-library/documentation/en/lwc/lwc.reference_configuration_tags)).

--
|===
| Metadata | Value

| `apiVersion` | `57.0`
| `isExposed` | `false`
|===
--