# package version update

Update a package version.

## Description for package version update

Specify a new value for each option you want to update.

To display details about a package version, run "sf package version display".

## Aliases for package version update

`force:package:version:update`

## 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                                                               |
| `--branch`              | `-b`              | **Type:** Value<br><br>New package version branch.                                                                                                       |
| `--flags-dir`           | N/A               | **Type:** Value<br><br>Import flag values from a directory.                                                                                              |
| `--installation-key`    | `-k`              | **Type:** Value<br><br>New installation key for key-protected package (default: null)                                                                    |
| `--json`                | N/A               | **Type:** Boolean<br><br>Format output as json.                                                                                                          |
| `--package`             | `-p`              | **Type:** Value<br>**Required**<br><br>ID (starts with 04t) or alias of the package to update a version of.                                              |
| `--tag`                 | `-t`              | **Type:** Value<br><br>New package version tag.                                                                                                          |
| `--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. |
| `--version-description` | `-e`              | **Type:** Value<br><br>New package version description.                                                                                                  |
| `--version-name`        | `-a`              | **Type:** Value<br><br>New package version name.                                                                                                         |

## Examples for package version update

Update the package version that has the specified alias (that contains spaces) with a new installation key "password123"; uses your default Dev Hub org:

```shell
sf package version update --package "Your Package Alias" --installation-key password123
```

Update the package version that has the specified ID with a new branch and tag; use the Dev Hub org with username <devhub@example.com>:

```shell
sf package version update --package 04t... --branch main --tag 'Release 1.0.7' --target-dev-hub devhub@example.com
```

Update the package version that has the specified ID with a new description:

```shell
sf package version update --package 04t... --version-description "New Package Version Description"
```