---
title: esc env edit | CLI commands
url: /docs/esc/cli/commands/esc_env_edit/
---

Edit an environment definition

## Synopsis

Edit an environment definition

This command fetches the current definition for the named environment and opens it
for editing in an editor. The editor defaults to the value of the VISUAL environment
variable. If VISUAL is not set, EDITOR is used. These values are interpreted as
commands to which the name of the temporary file used for the environment is appended.
If no editor is specified via the --editor flag or environment variables, edit
defaults to `vi`.

```
esc env edit [<org-name>/][/]<environment-name> [flags]
```

## Options

```
      --draft string[="new"]   set flag without a value (--draft) to create a draft rather than saving changes directly. --draft=<change-request-id> to update an existing change request.
      --editor string          the command to use to edit the environment definition
  -f, --file -                 the file that contains the updated environment, if any. Pass - to read from standard input.
  -h, --help                   help for edit
      --show-secrets           Show static secrets in plaintext rather than ciphertext
```

## Options inherited from parent commands

```
      --env string   The name of the environment to operate on.
```

## SEE ALSO

* [esc env](/docs/esc/cli/commands/esc_env/)	 - Manage environments