# Version Groups

`version.groups` defines batches of related version entries. Groups let you apply shared policy and limit commands such as `lock`, `update`, `status`, and `diff` with `--group`.

## Configuration

**File:** `atmos.yaml`

```yaml
version:
  groups:
    infrastructure:
      ecosystems:
        - toolchain
        - github/actions
        - oci
      patterns:
        - opentofu
        - actions/*
        - nginx
      exclude_patterns:
        - experimental/*
      update:
        strategy: minor
        cooldown: 14d
      exclude:
        - "1.5.*"
      prerelease: false
      labels:
        - infrastructure
```

## Fields

- **`ecosystems`**
  Match entries by ecosystem.
- **`datasources`**
  Match entries by datasource.
- **`providers`**
  Match entries by provider name.
- **`patterns`**
  Entry-name patterns included in the group.
- **`exclude_patterns`**
  Entry-name patterns excluded from the group.
- **`update`, `include`, `exclude`, `prerelease`, `labels`**
  Policy applied to entries that match the group.

## Examples

```yaml
version:
  groups:
    github_actions:
      ecosystems: [github/actions]
      update:
        strategy: minor
        cooldown: 3d
      exclude:
        - "v4.0.0"
```

```shell
atmos version track status prod --group=github_actions
atmos version track update prod --group=github_actions
```