# package version promote

Promote a package version to released.

## Description for package version promote

Supply the ID or alias of the package version you want to promote. Promotes the package version to released status.

## Aliases for package version promote

`force:package:version:promote`

## Flags

| Flag Name (Long)   | Flag Name (Short) | Description                                                                                                                                              |
| ------------------ | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--api-version`    | N/A               | **Type:** Value<br><br>Override the api version used for api requests made by this command                                                               |
| `--flags-dir`      | N/A               | **Type:** Value<br><br>Import flag values from a directory.                                                                                              |
| `--json`           | N/A               | **Type:** Boolean<br><br>Format output as json.                                                                                                          |
| `--no-prompt`      | `-n`              | **Type:** Boolean<br><br>Don't prompt to confirm setting the package version as released.                                                                |
| `--package`        | `-p`              | **Type:** Value<br>**Required**<br><br>ID (starts with 04t) or alias of the package version to promote.                                                  |
| `--target-dev-hub` | `-v`              | **Type:** Value<br>**Required**<br><br>Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set. |

## Examples for package version promote

Promote the package version with the specified ID to released; uses your default Dev Hub org:

```shell
sf package version promote --package 04t...
```

Promote the package version with the specified alias to released; uses the Dev Hub org with username <devhub@example.com>:

```shell
sf package version promote --package awesome_package_alias --target-dev-hub devhub@example.com
```

Promote the package version with an alias that has spaces to released:

```shell
sf package version promote --package "Awesome Package Alias"
```