---
title: "ktm variables groups"
description: "Variable groups: environment configurations holding a set of variants"
sidebarTitle: "groups"
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

{/* GENERATED FILE: do not edit by hand. Regenerate with: node scripts/generate.mjs */}

Variable groups — environment configurations holding a set of variants

<Note>Aliases: groups, group</Note>

## Usage

```bash
ktm variables groups [flags]
```

## Subcommands

<Columns cols={2}>
  <Card title="create" icon="angle-right" href="/cli/commands/variables/groups/create">
    Create a variable group with variants
  </Card>
  <Card title="delete" icon="angle-right" href="/cli/commands/variables/groups/delete">
    Delete a variable group; refuses if non-empty unless --force
  </Card>
  <Card title="list" icon="angle-right" href="/cli/commands/variables/groups/list">
    List variable groups for a product
  </Card>
  <Card title="show" icon="angle-right" href="/cli/commands/variables/groups/show">
    Get variable group detail including variants and variable definitions
  </Card>
  <Card title="update" icon="angle-right" href="/cli/commands/variables/groups/update">
    Rename a variable group (variants management is in 'variables variants')
  </Card>
</Columns>

## Details

Manage variable groups under the variables umbrella.

Variants management lives under 'ktm variables variants' (add | remove | rename
| set-default | copy-values). The 'groups update' command is rename-only.

## Related

- [`ktm variables`](/cli/commands/variables)

<Note>
  Global flags (`--output`, `--debug`, `--host`, …) apply to every command. See the [command reference overview](/cli/commands/overview).
</Note>

## What's next?

<Columns cols={2}>
  <Card title="All commands" icon="terminal" href="/cli/commands/overview">
    Browse the full CLI reference.
  </Card>
  <Card title="Get started" icon="rocket" href="/cli/getting-started">
    Install the CLI and authenticate.
  </Card>
</Columns>