---
title: "ktm variables list"
description: "List variables for a product (with scope, group, type, usage, and variant filters)"
sidebarTitle: "list"
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 */}

List variables for a product (with scope, group, type, usage, and variant filters)

## Usage

```bash
ktm variables list [flags]
```

## Examples

```bash
ktm variables list --product acme~web
ktm variables list --product acme~web --scope global
ktm variables list --product acme~web --group 42 --type secret
ktm variables list --product acme~web --used false
ktm variables list --product acme~web --variant prod
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--group` | int |  | Optional variable group id |
| `--product` | string |  | Product slug (required) |
| `--scope` | string | `all` | global \| grouped \| all |
| `--type` | string |  | single \| secret \| choice |
| `--used` | string |  | true \| false — filter by usage state |
| `--variant` | string |  | Variant name or id — keep only variables carrying this variant |

## Details

Default scope returns ALL variables (global + grouped). Filter the result with:

  --scope global|grouped|all   default: all
  --group <id>                 restrict to one variable group
  --type single|secret|choice  filter by type
  --used true|false            filter by usage state
  --variant <name|id>          restrict to variables that carry the variant

Secrets are returned masked by the platform.

## 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>