> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# roark metric variant create

> Create a metric variant

Add a configuration of this metric for your organization, seeded from its Default. Edit it with PUT to change what it measures, then pin it where you want it used. Threshold metrics have no variants: their configuration comes from the metric they derive from. Metrics in a package that manages its own variants reject this too.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark metric variant create <id-or-slug> [options]
```

> [!NOTE]
>
> Calls `POST /v1/metric/definitions/{idOrSlug}/variants`

## Arguments

**id-or-slug** `string` *required*

Metric definition UUID or its stable slug.

## Options

**--name** `string` *required*

Name for the new variant. Must be unique for this metric within your organization and cannot be `Default`.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark metric variant create <id-or-slug> --name <value>
```

Every command also takes the [global options](/cli-reference/overview.md#global-options) and sets one
of the [exit codes](/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.