> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appz.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# appz promote

> Learn how to promote an existing deployment using the `appz promote` CLI command.

export const GlobalOptionsComponent = ({command}) => <div>
    <h2><a href="#global-options">Global Options</a></h2>
    <p>These general options can be applied when using the <code>{command}</code> command:</p>
    <ul>
    <li><code>--cwd</code></li>
    <li><code>--debug</code></li>
    <li><code>--global-config</code></li>
    <li><code>--help</code></li>
    <li><code>--local-config</code></li>
    <li><code>--no-color</code></li>
    <li><code>--scope</code></li>
    <li><code>--token</code></li>
    </ul>

    <p>For detailed information on these global options and their applications, refer to the <a href="/cli/global-options">options section</a>.</p>
    </div>;

The `appz promote` command is used to elevate an existing deployment to be the current deployment.

Deployments created for the Production environment are typically the target for promotions. It's possible to promote deployments from the Preview environment, but you will need to confirm this action, resulting in a new production deployment. The prompt can be bypassed by using the `--yes` option.

## Usage

```bash terminal theme={null}
appz promote [deployment-id or url]
```

> Executing the `appz promote` command will make the specified deployment the current one.

## Unique Options

These options are specific only to the appz promote command.

### Timeout

The `--timeout` option specifies the duration that the appz promote command will wait for the promotion to be finalized. If a timeout occurs, it does not impact the actual promotion, which will continue as planned.

Promoting a deployment with a timeout of 0 means that the command will exit immediately after the promotion request is made.

```bash theme={null}
appz promote https://example-app-6vd6bhoqt.appz.dev --timeout=5m
```

> Using the appz promote command with the --timeout option.

<GlobalOptionsComponent command={'appz promote'} />