---
title: "ResultsOptions"
slug: "cloud-sdk-search-resultsoptions"
abstract: "The ResultsOptions interface represents the results object of a widget item."
---
# ResultsOptions

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

The results object of a widget item.

## Signature

```typescript
export interface WidgetItemRecommendation {
  content?: ContentOptions;
  filter?: Filter;
  groupBy?: string;
  limit?: number;
  rule?: SearchRuleOptions;
}
```

## Properties

| Name | Type | Description | Value |
| --- | --- | --- | --- |
| `content` | [`ContentOptions`](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-search/cloud-sdk-search-browser/types/cloud-sdk-search-contentoptions.html "ContentOptions") | Optional.<br><br>The content options property of the results widget item. Used to select the attributes to request for each item. For example, to request only the `title` and `description` attributes. | N/A |
| `filter` | [`Filter`](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-search/cloud-sdk-search-browser/types/cloud-sdk-search-filter.html "Filter") | Optional.<br><br>Various filter criteria that can be used to filter the content to be returned. | N/A |
| `groupBy` | `string` | Optional.<br><br>The attribute to group or collapse results by.<br><br>The attribute must be defined in Sitecore Search.<br><br>For example, group recommendations by color or country. | `"group_id"` |
| `limit` | `integer` | Optional.<br><br>The number to set as the results limit.<br><br>[Used for pagination](https://doc.sitecore.com/search/en/developers/search-developer-guide/en/using-pagination.html) by specifying the maximum number of results to return.<br><br>Minimum: `1`.<br><br>Maximum: `100`. | `25` |
| `rule` | [`SearchRuleOptions`](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/cloud-sdk-reference/cloud-sdk-search/cloud-sdk-search-browser/interfaces/cloud-sdk-search-searchruleoptions.html "SearchRuleOptions") | Optional.<br><br>Options for rules. Rules are modifications to widget behavior that can be used to overwrite the natural set of search results, for example, to boost, bury, pin, and blacklist items. | N/A |