| --- |
| page_title: 'Command: show' |
| description: >- |
| The `terraform show` command is used to provide human-readable output from a |
| state or plan file. This can be used to inspect a plan to ensure that the |
| planned operations are expected, or to inspect the current state as Terraform |
| sees it. |
| --- |
| |
| # Command: show |
| |
| The `terraform show` command is used to provide human-readable output |
| from a state or plan file. This can be used to inspect a plan to ensure |
| that the planned operations are expected, or to inspect the current state |
| as Terraform sees it. |
| |
| Machine-readable output is generated by adding the `-json` command-line |
| flag. |
| |
| -> **Note:** When using the `-json` command-line flag, any sensitive values in |
| Terraform state will be displayed in plain text. For more information, see |
| [Sensitive Data in State](/language/state/sensitive-data). |
| |
| ## JSON Output |
| |
| For Terraform state files (including when no path is provided), |
| `terraform show -json` will show a JSON representation of the state. |
| |
| For Terraform plan files, `terraform show -json` will show a JSON representation |
| of the plan, configuration, and current state. |
| |
| If you've updated providers which contain new schema versions since the state |
| was written, the state needs to be upgraded before it can be displayed with |
| `show -json`. If you are viewing a plan, it must be created without |
| `-refresh=false`. If you are viewing a state file, run `terraform refresh` |
| first. |
| |
| The output format is covered in detail in [JSON Output Format](/internals/json-format). |
| |
| ## Usage |
| |
| Usage: `terraform show [options] [file]` |
| |
| You may use `show` with a path to either a Terraform state file or plan |
| file. If you don't specify a file path, Terraform will show the latest state |
| snapshot. |
| |
| This command accepts the following options: |
| |
| * `-no-color` - Disables output with coloring |
| |
| * `-json` - Displays machine-readable output from a state or plan file |
| |
| -> JSON output via the `-json` option requires **Terraform v0.12 or later**. |