---
title: "ForEach in Group Step"
slug: "foreach-in-group-step"
tags: ["ForEach", "Iteration", "Flow management"]
updated: 2025-01-22T19:49:58Z
published: 2025-01-22T19:49:58Z
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** | 9.7.0 |
| **Location** | Flow Management > Iteration |

The ForEach in Group step groups a list of objects for a datatype based on a specific field. Any items that have matching values in the field will be grouped together and outputted as a group. The step will iterate through each group before reaching completion.

---

## Properties

#### Data

| Property | Description | Data Type |
| --- | --- | --- |
| Type | The datatype that will be used by the step. This field will be automatically updated based on the Collection input | --- |
| Get Field to Group By From Input | Enabling this moves the "Field to Group By" property to the Inputs section, allowing for dynamic grouping. | Boolean |
| Field to Group By | Select the data field to group the objects by. | --- |

### Inputs

| Property | Description | Data Type |
| --- | --- | --- |
| Field to Group By | The specified field in the datatype to group by. Any values that have a match on this field will | String |
| Collection | The list of objects that will be grouped by the step. | List of Object |

### Outputs

| Property | Description | Data Type |
| --- | --- | --- |
| Each Grouping | The outputted lists based on matching values for a field. | --- |

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

---

## Step Changes

| Description | Version | Release Date | Developer Task |
| --- | --- | --- | --- |
| Added "Get Field To Group By From Input" setting. | [9.7](https://documentation.decisions.com/v99/docs/version-97x-release-notes) | February 2025 | [DT-021003] |