[Home](./index.md) > [@empathyco/x-components](./x-components.md) > [groupItemsBy](./x-components.groupitemsby.md) ## groupItemsBy() function Groups the array items based on the provided `groupBy` function. **Signature:** ```typescript export declare function groupItemsBy(array: ArrayType[], groupBy: (item: ArrayType, index: number) => ReturnType): Record; ``` ## Parameters

Parameter	Type	Description
array	ArrayType\[\]	The array to iterate, grouping its items in different arrays based on the `groupBy` function.
groupBy	(item: ArrayType, index: number) => ReturnType	A function to determine the group name of a single item.

**Returns:** Record<ReturnType, ArrayType\[\]> The items grouped in a dictionary.