When you “remove” a UPM packageA Package managed by the Unity Package Manager. Refer to Packages.
See in Glossary from your project, the Package Manager is actually removing the project’s direct dependencyA direct dependency occurs when your project “requests” a specific package version. To create a direct dependency, you add that package and version to the dependencies property in your project manifest (expressed in the form package_name@package_version
). More info
See in Glossary from your project manifestEach Unity project has a project manifest, which acts as an entry point for the Package Manager. This file must be available in the <project>/Packages
directory. The Package Manager uses it to configure many things, including a list of dependencies for that project, as well as any package repository to query for packages. More info
See in Glossary. The result of removing the direct dependency varies, based on the dependencies for the package you are removing:
alembic@1.0.7
package which in turn depends on the timeline@1.0.0
package, then your project has an direct dependency on Alembic and an indirect dependency on Timeline. More infoMake sure you understand these important notes before you begin:
Use this procedure to remove a package only if you added it to the current project by installing it, such as (but not limited to) Install a feature set, Install a UPM package from a registry, Install a UPM package from Asset Store, and installing custom packages. Don’t use this procedure to try to:
.unitypackage
extension. Asset packages are a handy way of sharing and re-using Unity projects and collections of assets. More infoIf you use this procedure to remove a UPM package that you installed from a registry or installed from the Asset Store, the operation removes the package from the current project. It doesn’t remove the same package that might exist in other projects. It also doesn’t remove the package from the global cache; this action isn’t supported by the Package Manager, and manually manipulating the global cache is discouraged.
If you use this procedure to remove a package that you embedded in your project, the Package Manager deletes the entire package folder from your computer. However, removing packages installed from any other source (including local packages) removes only the reference to the package in the manifest but leaves the package itself and its contents intact.
To remove an installed package:
Open the Package Manager window and select In Project from the navigation panel.
Select the package you want to remove from the list of packages. The details panel now displays that package’s information.
Click Remove.
If this button isn’t displayed, you might be viewing the My Assets list. Refer to Before you begin.
If this button is disabled, you can’t remove this package. Hover over the button to find out why you can’t remove the package. For more information, refer to Locked and non-removable packages.
When the progress bar finishes, the package disappears from the list.
If you want to restore a removed UPM package, follow the instructions to install a UPM package from a registry or install a UPM package from the Asset Store.
Note: You can remove 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.
You can remove packages only if they’re not required by another package or a feature set. The Package Manager enforces this by disabling the Remove button for all required packages.
Required by | Description |
---|---|
A feature set | If a feature set requires the package, it displays a lock icon () in both the list panel and in the details panel. The details panel also displays the name of the feature set that requires the package below the lock icon in the details panel. However, even if you click the Unlock button, you still can’t remove the package from your project until you remove all feature sets that require it. Unlocking the package lets you request a different version for your project, but it still doesn’t let you remove it. |
Another package | If one or more packages require the selected package, the Remove button is disabled. You can find the name of the package that has the dependency from the Dependencies tab in the details panel. If you don’t need the other packages, you can remove them and the Package Manager automatically removes this package too. |
Note: You can unlock 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.