---
title: Create product suggestions configurations
slug: p66a0379
canonical_url: https://docs.coveo.com/en/p66a0379/
collection: coveo-for-commerce
source_format: adoc
---
# Create product suggestions configurations
Product suggestions (known as _Instant products_ in [Coveo Headless](https://docs.coveo.com/en/lcdf0493/) and [Coveo Atomic](https://docs.coveo.com/en/lcdf0264/)) display products that match the user's query as they type in the search box.
When implemented, end-users can select products straight from the search box.

![Product suggestions appearing in the search box as a user types | Coveo for Commerce](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/product-suggestions.png)

You can override the default product suggestions configuration to change its behavior.
For example, you might want to change the maximum number of products that are displayed in the suggestions.

A product suggestions configuration applies globally to a specific [tracking ID](https://docs.coveo.com/en/o8rb0139/), meaning that all [queries](https://docs.coveo.com/en/231/) made with that [tracking ID](https://docs.coveo.com/en/o8rb0139/) will use the same product suggestions configuration, regardless of the [locale](https://docs.coveo.com/en/p4tf0351/).

> **Note**
>
> Merchandising rules defined in the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/) apply to the product suggestions.

## Prerequisites

You must have created a [Predictive Query Suggestion model](https://docs.coveo.com/en/lcee0589/) or [Query Suggestion model](https://docs.coveo.com/en/p26b0268/), and have implemented [query suggestions](https://docs.coveo.com/en/1015/) in your search box.
Refer to the following articles to learn how to implement query suggestions in your search box depending on whether you're using Headless SSR or CSR:

* [Headless SSR](https://docs.coveo.com/en/p25b0411#creating-a-search-box)

* [Headless CSR](https://docs.coveo.com/en/p25a2501#creating-a-search-box)

## Create a product suggestions configuration

To create a product suggestions configuration, use the [Product suggestion configuration endpoint](https://docs.coveo.com/en/103#tag/Product-suggest-Configurations/operation/create_1).

Here's a sample product suggestions configuration JSON:

```json
{
  "trackingId": "<TRACKING ID>", <1>
  "queryConfiguration": { <2>
    "additionalFields": [
      "color",
      "shirtsize"
    ],
    "perPage": 2
  }
}
```

<1> The [tracking ID](https://docs.coveo.com/en/o8rb0139/) of the product suggestions configuration.
The configuration applies globally to all [queries](https://docs.coveo.com/en/231/) made with that [tracking ID](https://docs.coveo.com/en/o8rb0139/), regardless of the [locale](https://docs.coveo.com/en/p4tf0351/).

<2> The query configuration for the product suggestions.
You can specify the following properties:

* `additionalFields`: An array of additional fields to return for the products shown in the suggestions.

* `perPage`: The maximum number of products to display in the suggestions.