---
title: pulumi state promote | CLI commands
url: /docs/iac/cli/commands/pulumi_state_promote/
---



Promote a snippet from state into Pulumi program code

## Synopsis

Promote a snippet from state into Pulumi program code

This command generates Pulumi program code for a stateful snippet, prints the
generated files, then removes the snippet from the stack while leaving the
resources it registered in state. The argument is the snippet's logical name.

This command must be run from a real Pulumi project so the generated code has
a backing project runtime.

```
pulumi state promote <snippet-name> [flags]
```

## Examples

```
pulumi state promote myBucket
```

## Options

```
  -h, --help           help for promote
  -s, --stack string   The name of the stack to operate on. Defaults to the current stack
  -y, --yes            Skip confirmation prompts
```

## Options inherited from parent commands

```
      --color string                 Colorize output. Choices are: always, never, raw, auto (default "auto")
  -C, --cwd string                   Run pulumi as if it had been started in another directory
      --disable-integrity-checking   Disable integrity checking of checkpoint files
  -e, --emoji                        Enable emojis in the output
  -Q, --fully-qualify-stack-names    Show fully-qualified stack names
      --logflow                      Flow log settings to child processes (like plugins)
      --logtostderr                  Log to stderr instead of to files
      --memprofilerate int           Enable more precise (and expensive) memory allocation profiles by setting runtime.MemProfileRate
      --non-interactive              Disable interactive mode for all commands
      --otel-traces string           Export OpenTelemetry traces to the specified endpoint. Use file:// for local JSON files, grpc:// or https:// for remote collectors
      --profiling string             Emit CPU and memory profiles and an execution trace to '[filename].[pid].{cpu,mem,trace}', respectively
      --tracing file:                Emit tracing to the specified endpoint. Use the file: scheme to write tracing data to a local file
  -v, --verbose int                  Enable verbose logging (e.g., v=3); anything >3 is very verbose
```

## SEE ALSO

* [pulumi state](/docs/iac/cli/commands/pulumi_state/)	 - Edit the current stack's state