# atmos aws cloudformation plan

Preview changes an apply would make to a CloudFormation stack. `plan` is an
alias for [`diff`](/cli/commands/aws/cloudformation/diff): it creates (or
reuses) a changeset and renders the predicted changes without executing it.

> ⚠️ Experimental

## Usage

```shell
atmos aws cloudformation plan <component> --stack <stack> [options]
atmos aws cloudformation plan vpc -s plat-ue2-dev

# Plan components filtered by tags or labels (composes with --all/--affected)
atmos aws cloudformation plan --all --tags production,tier-1
atmos aws cloudformation plan --affected --labels cost-center=platform
```

## Flags

- **`--stack`, `-s` (required for a single component)**
  Atmos stack. Required when operating on a single component; optional (and used only to narrow the selected set) with 
  `--all`
  /
  `--affected`
  .
- **`--all` / `--affected` / `--include-dependents` (optional)**
  Process multiple 
  `aws/cloudformation`
   components in dependency order. See 
  [`diff`](/cli/commands/aws/cloudformation/diff)
  .
- **`--tags` / `--labels` (optional)**
  Filter by tags (comma-separated, matches any) or labels (comma-separated 
  `key=value`
   or 
  `key:value`
   pairs, matches all): 
  `--tags=production,tier-1`
  , 
  `--labels=cost-center=platform`
  . Compose with 
  `--all`
  /
  `--affected`
   to narrow the selected set further; cannot be combined with a single component argument.