# coder secret list

List secrets, or show one by name

Aliases:

* ls

## Usage [#usage]

```console
coder secret list [flags] [name]
```

## Description [#description]

```console
Secret values are omitted from the output.

When listing all secrets inside a workspace, or with --workspace or --build-id, the workspace build's secrets are included and the source and "replaced by" columns are shown by default. If a build secret uses the same env var or file as a user secret, the user secret is not delivered on that target and its "replaced by" column names the build secret, for example "env: build/github-token".
```

## Options [#options]

### --workspace [#--workspace]

|      |                     |
| ---- | ------------------- |
| Type | <code>string</code> |

Include the secrets of this workspace's latest build. Inside a workspace, the default is the build the workspace agent was started from.

### --build-id [#--build-id]

|      |                     |
| ---- | ------------------- |
| Type | <code>string</code> |

Include the secrets of this workspace build. Takes precedence over --workspace.

### -c, --column [#-c---column]

|         |                                                                                                         |
| ------- | ------------------------------------------------------------------------------------------------------- |
| Type    | <code>\[created\|name\|updated\|source\|env\|file\|enabled\|replaced by\|ephemeral\|description]</code> |
| Default | <code>name,created,updated,env,file,enabled,description</code>                                          |

Columns to display in table output.

### -o, --output [#-o---output]

|         |                          |
| ------- | ------------------------ |
| Type    | <code>table\|json</code> |
| Default | <code>table</code>       |

Output format.