Switch to another version of a UPM package

Use the information on this page to update UPM packagesA Package managed by the Unity Package Manager. Refer to Packages.
See in Glossary that you installed from the Unity Registry or a scoped registry, or from a local source. The information on this page also applies to packages you installed from the Asset Store, if they’re in the UPM format.

If you want to install a specific version of a package, refer to install the package by name and follow its optional step to specify a version.

If you want to update packages that you installed from a Git URL, you can use any of the following methods:

• Locate the package in the Package Manager window, select it, then click the Update button.
• Reinstall the package as a Git dependency using a new revision. For more information about how to specify revisions with Git dependenciesThe Package Manager retrieves Git dependencies from a Git repository directly rather than from a package registry. Git dependencies use a Git URL reference instead of a version, and there’s no guarantee about the package quality, stability, validity, or even whether the version stated in its package.json file respects Semantic Versioning rules with regards to officially published releases of this package. More info
  See in Glossary, refer to Targeting a specific revision.
• Reinstall the package from the Unity Registry.

To update a package:

1. Open the Package Manager window and select In Project, Unity Registry, or My Registries from the navigation panel. You can also select the Updates entry, which lists all packages in your project that have updates available. An arrow icon () appears next to packages that have updates available.

2. Select the installed package you want to update from the list of packages. The package information appears in the details panel.

3. The lock icon () indicates that this package and version is locked to an installed feature setA feature set is a collection of related packages that you can use to achieve specific results in the Unity Editor. You can manage feature sets directly in Unity’s Package Manager. More info
   See in Glossary. To unlock the package and select another version, click the Unlock button.

   Note: The package is temporarily unlocked. If you select a different context in the navigation panel, or close either the Package Manager window or the Unity Editor, the package reverts to a locked state. However, if you change versions when the package is unlocked (for example, with the Install a package from a registry by name method), the package stays unlocked.

4. Select a package in the list of packages.

   

5. In the details panel, select the Version History tab. If multiple versions are available, expand the entries to view information specific to each version.

   

6. Click the Update to #.# button, or click the Update button beside the version listed in the Version History tab.

   When the progress bar finishes, any new functionality is immediately available.

Notes:

• If you switch to an older version of a package, you might have to run the API Updater on the package contents.
• You can switch versions for multiple packages with one click by using the multiple select feature. For more information, refer to Perform an action on multiple packages or feature sets.

Additional resources

• Package types
• Add and remove UPM packages or feature sets