# Grouping

The KendoReact `AutoComplete` provides the option to display grouped data inside the component. The current article discusses the following AutoComplete Grouping scenarios:

* [Basic usage and differences between the two grouping modes available for the component](https://www.telerik.com/kendo-react-ui-develop/components/dropdowns/autocomplete/grouping#basic-usage)
* [Customization of the different popup elements when working with grouped data](https://www.telerik.com/kendo-react-ui-develop/components/dropdowns/autocomplete/grouping#grouping-customization)
* [Grouping with filtering](https://www.telerik.com/kendo-react-ui-develop/components/dropdowns/autocomplete/filtering#grouping-with-filtering)

## Basic Usage

To configure the data grouping in the AutoComplete component you need to define the [`groupField`](https://www.telerik.com/kendo-react-ui-develop/components/dropdowns/api/autocompleteprops#groupfield).

* The `groupField` property sets the fields that defines the group name in each data item.

> The Grouping functionality has the following specifics:
>
> 1. AutoComplete doesn't internally group the data passed to it. To use the component in a grouping scenario, you need to use the `groupBy` method available in the KendoReact DataQuery package.
> 2. Data that can't be grouped is not visualized in the component - the AutoComplete internally filters the data items that doesn't have the field that is set as a `groupField`.

The following example demonstrates the AutoComplete data grouping in action.

[Demo Source](https://demos.telerik.com/kendo-react-ui/dropdowns/autocomplete/grouping/source.txt)

## Grouping Customization

Using the [itemRender](https://www.telerik.com/kendo-react-ui-develop/components/dropdowns/api/autocompleteprops#itemrender), [groupHeaderItemRender](https://www.telerik.com/kendo-react-ui-develop/components/dropdowns/api/autocompleteprops#groupheaderitemrender), and [groupStickyHeaderItemRender](https://www.telerik.com/kendo-react-ui-develop/components/dropdowns/api/autocompleteprops#groupstickyheaderitemrender) of the KendoReact AutoComplete component we can customize its `data items`, `group headers`, and the `'sticky' header` that displays the top-most group that is
currently being scrolled.

By customizing the templates passed to each of the listed above properties you can modify the grouped AutoComplete data the way your scenario needs it.

[Demo Source](https://demos.telerik.com/kendo-react-ui/dropdowns/autocomplete/grouping-custom/source.txt)

## Suggested Links

* [API Reference of the AutoComplete](https://www.telerik.com/kendo-react-ui-develop/components/dropdowns/api/autocomplete)
* [API Reference of the AutoCompleteProps](https://www.telerik.com/kendo-react-ui-develop/components/dropdowns/api/autocompleteprops)
