---
title: "ForEach in Group Step"
slug: "foreach-in-group-step"
description: "Learn how the ForEach in Group step organizes a list of objects into groups based on a selected field within a Flow."
tags: ["ForEach", "Iteration", "Flow management"]
updated: 2026-05-15T20:33:21Z
published: 2026-05-15T20:33:21Z
canonical: "documentation.decisions.com/foreach-in-group-step"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ForEach in Group Step

## Overview

| ## Step Details |
| --- |
| **Introduced in Version** | 3.0.0 |
| **Last Modified in Version** | 8.0.0 |
| **Location** | Flow Management > Iteration |

The ForEach in Group step groups a list of objects for a datatype together based on a specific field.

---

## Properties

| Property | Description | Data Type |
| --- | --- | --- |
| **Data** |
|  | Type | Defines which datatype or structure will be used for inputs/outputs. | Determined by the user |
| **Inputs** |
|  | Field to Group By | Determines which field to group the list of objects by. | Determined by Type |
|  | Collection | The inputted list of objects. | Determined by Type |
| **Outputs** |
|  | Each Grouping | Outputs a list of grouped objects based on a field. | Determined by Type |

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1778790400623.png)

Reference Articles[ForEach in Group step](https://documentation.decisions.com/projects/docs/for-each-in-group-step)