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

# package update

Update package details.

## Description for package update

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

Run "sf package list" to list all packages in the Dev Hub org.

## Aliases for package update

`force:package:update`

## 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;description</code> | <code>&#8209;d</code> | **Type:** Value<br><br>New description of the package. |
| <code>&#8209;&#8209;enable&#8209;app&#8209;analytics</code> | N/A | **Type:** Boolean<br><br>Enable AppExchange App Analytics usage data collection on this managed package and its components. |
| <code>&#8209;&#8209;error&#8209;notification&#8209;username</code> | <code>&#8209;o</code> | **Type:** Value<br><br>Active Dev Hub user designated to receive email notifications for package errors.<br><br>Email notifications include information about unhandled Apex exceptions, and install, upgrade, or uninstall failures associated with your package. |
| <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;name</code> | <code>&#8209;n</code> | **Type:** Value<br><br>New name of the package. |
| <code>&#8209;&#8209;package</code> | <code>&#8209;p</code> | **Type:** Value<br>**Required**<br><br>ID (starts with 0Ho) or alias of the package to update. |
| <code>&#8209;&#8209;recommended&#8209;version&#8209;id</code> | <code>&#8209;r</code> | **Type:** Value<br><br>ID of the package version that's installed when subscribers click the Upgrade to Recommended Version option on the Installed Packages page of their org.<br><br>Specify the recommended package version for subscribers to install. If a subscriber has a package version installed in their org that's lower than the version you set, the subscriber sees the Upgrade to Recommended Version option on the Installed Packages page. Only released package versions can be set as the recommended version. |
| <code>&#8209;&#8209;skip&#8209;ancestor&#8209;check</code> | N/A | **Type:** Boolean<br><br>Bypass the ancestry check for setting a recommended version. |
| <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 update

Update the name of the package with the specified alias; uses your default Dev Hub org:

```shell
sf package update --package "Your Package Alias" --name "New Package Name"
```

Update the description of the package with the specified ID; uses the specified Dev Hub org:

```shell
sf package update --package 0Ho... --description "New Package Description" --target-dev-hub devhub@example.com
```
<!-- prettier-ignore-end -->