terraform/website/docs/cli/commands/workspace/select.html.md

---
layout: "docs"
page_title: "Command: workspace select"
sidebar_current: "docs-commands-workspace-sub-select"
description: |-
  The terraform workspace select command is used to choose a workspace.
---

# Command: workspace select

The `terraform workspace select` command is used to choose a different
workspace to use for further operations.

## Usage

Usage: `terraform workspace select [NAME]`

This command will select another workspace. The named workspace must already
exist.

## Example

```
$ terraform workspace list
  default
* development
  jsmith-test

$ terraform workspace select default
Switched to workspace "default".
```
website: replace "env" command docs with "workspace" command docs We are replacing this terminology. The old command continues to work for compatibility, but is deprecated. The docs should reflect the currently-recommended form. 2017-05-31 02:46:12 +02:00			`---`
website: Adopt islanded subcommands into unified "docs" (CLI) layout Several `terraform` subcommands include sub-sub-commands; with our old sidebar system, viewing those took you to an isolated "island" nav sidebar, away from the main docs. The new navigation will adopt all these pages, so we don't need to exile the reader to odd places. 2020-10-27 01:58:30 +01:00			`layout: "docs"`
website: replace "env" command docs with "workspace" command docs We are replacing this terminology. The old command continues to work for compatibility, but is deprecated. The docs should reflect the currently-recommended form. 2017-05-31 02:46:12 +02:00			`page_title: "Command: workspace select"`
website: Reorganize nav sidebars to improve jumps between sections 2018-12-21 03:18:13 +01:00			`sidebar_current: "docs-commands-workspace-sub-select"`
website: replace "env" command docs with "workspace" command docs We are replacing this terminology. The old command continues to work for compatibility, but is deprecated. The docs should reflect the currently-recommended form. 2017-05-31 02:46:12 +02:00			`description: \|-`
			`The terraform workspace select command is used to choose a workspace.`
			`---`

website: update "terraform env" reference to "terraform workspace" 2017-12-05 17:54:25 +01:00			`# Command: workspace select`
website: replace "env" command docs with "workspace" command docs We are replacing this terminology. The old command continues to work for compatibility, but is deprecated. The docs should reflect the currently-recommended form. 2017-05-31 02:46:12 +02:00
			The `terraform workspace select` command is used to choose a different
			`workspace to use for further operations.`

			`## Usage`

			Usage: `terraform workspace select [NAME]`

			`This command will select another workspace. The named workspace must already`
			`exist.`

			`## Example`

			```
			`$ terraform workspace list`
			`default`
			`* development`
			`jsmith-test`

			`$ terraform workspace select default`
			`Switched to workspace "default".`
			```