---
title: "SearchSuggestionOptions"
slug: "cloud-sdk-search-searchsuggestionoptions-1539452"
abstract: "The SearchSuggestionOptions interface represents the suggestion parameter of the search widget item. Used to configure search suggestions."
---
# SearchSuggestionOptions

|     |     |
| --- | --- |
| Type | Interface |
| Import path | `@sitecore-cloudsdk/search/server` |

The suggestion parameter of the search widget item. Used to configure search suggestions.

## Signature

```typescript
export interface SearchSuggestionOptions {
  exclude?: ArrayOfAtLeastOne<string>;
  keyphraseFallback?: boolean;
  max?: number;
  name: string;
}
```

## Properties

| Name | Type | Description | Value |
| --- | --- | --- | --- |
| `exclude` | `string[]` | Optional.<br><br>A list of search suggestions to exclude from the response for this suggestion.<br><br>Minimum length: 1. | `"sneakers"` |
| `keyphraseFallback` | `boolean` | Optional.<br><br>Whether you want Sitecore Search to use the first suggestion returned by this suggestion block as an alternate search keyphrase if the original keyphrase provided by the site visitor gives zero results.<br><br>Useful when a site visitor enters a keyphrase and clicks the search button instead of a suggestion. In this scenario, instead of showing the site visitor an empty search page, you can show search results for the alternate keyphrase.<br><br>If you request more than one `suggestion` object with `keyphraseFallback` set to `true`, Sitecore Search uses the first suggestion of the suggestion block.<br><br>To see the alternative keyphrase, in [`SearchOptions`](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-search/cloud-sdk-search-browser/interfaces/cloud-sdk-search-searchoptions.html "SearchOptions"), set `responseContext` to `true`. | `false` |
| `max` | `integer` | Optional.<br><br>The maximum number of search suggestions to retrieve.<br><br>Minimum: `1`.<br><br>Maximum: `100`.<br><br>Default: `10`. | `10` |
| `name` | `string` | Required.<br><br>The name of the suggestion block. Set to one of the suggestion block names.<br><br>To find suggestion block names in Sitecore Search, click **Administration** > **Domain Settings** > **Feature Configuration** > **Suggestion Blocks**. The name is in **Suggestion name**. | `"context_aware"` |