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

# astro env variable link list

<Info>
  This command is only available on Astro.
</Info>

Show every Deployment that a Workspace-scoped environment variable is linked to or excluded from. Identify the variable with either `--variable-key` or `--variable-id`.

## Usage

```bash wrap theme={null}
astro env variable link list
```

## Options

| Option              | Description                                                                          | Possible Values            |
| ------------------- | ------------------------------------------------------------------------------------ | -------------------------- |
| `--variable-key`    | The key of the Workspace variable. Provide either this or `--variable-id`.           | Any string                 |
| `--variable-id`     | The ID of the Workspace variable. Provide either this or `--variable-key`.           | Any valid variable ID      |
| `--format`          | The output format. Defaults to `table`.                                              | `table`, `json`, or `yaml` |
| `--include-secrets` | Surface secret values in the output. Requires an Organization policy that allows it. | None                       |
| `--workspace-id`    | Set the Workspace scope. Defaults to your current Workspace from CLI context.        | Any valid Workspace ID     |

## Examples

```bash wrap theme={null}
# Show every Deployment a Workspace variable is linked to or excluded from
astro env variable link list --variable-key DATABASE_URL --workspace-id <workspace-id>
```

## Related commands

* [`astro env variable link create`](/docs/cli/v1.43/astro-env-variable-link-create)
* [`astro env variable link delete`](/docs/cli/v1.43/astro-env-variable-link-delete)