---
schema_version: "1"
id: 9b70e0b6c5e63ec13b969718004a7c6a2f6f75fa6ac33e861b4aea0a2df28771
title: package version promote
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/salesforcedx/sfclireference/guides/package/cli_reference_package_version_promote.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_package_version_promote.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: a2b15ab14b858c1a46d3d169f79fdfef40c19b4558c371ff871e370a907f8d70
products:
  - Salesforce CLI Command Reference
  - salesforcedx
---
<!-- prettier-ignore-start -->

# 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 |
|------------------|-------------------|-------------|
| <code>&#8209;&#8209;api&#8209;version</code> | N/A | **Type:** Value<br><br>Override the api version used for api requests made by this command |
| <code>&#8209;&#8209;flags&#8209;dir</code> | N/A | **Type:** Value<br><br>Import flag values from a directory. |
| <code>&#8209;&#8209;json</code> | N/A | **Type:** Boolean<br><br>Format output as json. |
| <code>&#8209;&#8209;no&#8209;prompt</code> | <code>&#8209;n</code> | **Type:** Boolean<br><br>Don't prompt to confirm setting the package version as released. |
| <code>&#8209;&#8209;package</code> | <code>&#8209;p</code> | **Type:** Value<br>**Required**<br><br>ID (starts with 04t) or alias of the package version to promote. |
| <code>&#8209;&#8209;target&#8209;dev&#8209;hub</code> | <code>&#8209;v</code> | **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"
```
<!-- prettier-ignore-end -->