nushell/docs/commands/group-by.md

---
title: group-by
layout: command
version: 0.59.1
---

Create a new table grouped.

## Signature

```> group-by (grouper)```

## Parameters

 -  `grouper`: the grouper value to use

## Examples

group items by column named "type"
```shell
> ls | group-by type
```

you can also group by raw values by leaving out the argument
```shell
> echo ['1' '3' '1' '3' '2' '1' '1'] | group-by
```
Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			`---`
			`title: group-by`
			`layout: command`
fix typo, update some examples and regenerate docs (#4718) 2022-03-04 12:10:09 +00:00			`version: 0.59.1`
Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			`---`
add group-by command documentation 2019-11-16 14:31:28 +00:00
Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			`Create a new table grouped.`
add group-by command documentation 2019-11-16 14:31:28 +00:00
Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			`## Signature`
add group-by command documentation 2019-11-16 14:31:28 +00:00
Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			```> group-by (grouper)```
add group-by command documentation 2019-11-16 14:31:28 +00:00
Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			`## Parameters`
add group-by command documentation 2019-11-16 14:31:28 +00:00
Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			- `grouper`: the grouper value to use
add group-by command documentation 2019-11-16 14:31:28 +00:00
Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			`## Examples`
add group-by command documentation 2019-11-16 14:31:28 +00:00
Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			`group items by column named "type"`
add group-by command documentation 2019-11-16 14:31:28 +00:00			```shell
Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			`> ls \| group-by type`
add group-by command documentation 2019-11-16 14:31:28 +00:00			```

Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			`you can also group by raw values by leaving out the argument`
add group-by command documentation 2019-11-16 14:31:28 +00:00			```shell
Auto-generate markdown command docs (#4451) * Finish updating * a couple improvements * Update renames * cleanup examples 2022-02-14 02:22:51 +00:00			`> echo ['1' '3' '1' '3' '2' '1' '1'] \| group-by`
add group-by command documentation 2019-11-16 14:31:28 +00:00			```