terraform/website/docs/cli/state/inspect.mdx

---
page_title: Inspect Terraform state
description: The `terraform state` group of commands help you inspect Terraform state. Learn how inspecting Terraform state can help you read and update state.
---

⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️
> [!IMPORTANT]  
> **Documentation Update:** Product documentation previously located in `/website` has moved to the [`hashicorp/web-unified-docs`](https://github.com/hashicorp/web-unified-docs) repository, where all product documentation is now centralized. Please make contributions directly to `web-unified-docs`, since changes to `/website` in this repository will not appear on developer.hashicorp.com.
⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️


# Inspect Terraform State Overview

Terraform includes some commands for reading and updating state without taking
any other actions.

- [The `terraform state list` command](/terraform/cli/commands/state/list)
  shows the resource addresses for every resource Terraform knows about in a
  configuration, optionally filtered by partial resource address.

- [The `terraform state show` command](/terraform/cli/commands/state/show)
  displays detailed state data about one resource.

- [The `terraform refresh` command](/terraform/cli/commands/refresh) updates
  state data to match the real-world condition of the managed resources. This is
  done automatically during plans and applies, but not when interacting with
  state directly.