---
# Code generated by make gen. DO NOT EDIT.
title: "`coder list`"
description: List workspaces.
---
List workspaces
Aliases:
* ls
## Usage
```console
coder list [flags]
```
## Options
### -a, --all
| Property | Value |
|----------|-------------------|
| Type | bool |
Specifies whether all workspaces will be listed or not.
### --search
| Property | Value |
|----------|----------------------|
| Type | string |
| Default | user:me |
Search for a workspace with a query.
### -c, --column
| Property | Value |
|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Type | [favorite\|workspace\|organization id\|organization name\|template\|status\|healthy\|last built\|current version\|outdated\|starts at\|starts next\|stops after\|stops next\|daily cost] |
| Default | workspace,template,status,healthy,last built,current version,outdated,starts at,stops after |
Columns to display in table output.
### -o, --output
| Property | Value |
|----------|--------------------------|
| Type | table\|json |
| Default | table |
Output format.