Version: 2021.3
Language : English
Install a UPM package by name
Switch to another version of a UPM package

Remove a UPM package from a project

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:

  • If there are no other packages or feature sets that have a dependency on this package, any Editor or run-time functionality that it implemented is no longer available in your project. For more information about direct and indirect dependenciesAn indirect, or transitive dependency occurs when your project requests a package which itself “depends on” another package. For example, if your project depends on the 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 info
    See in Glossary
    , see Dependency and resolution.
  • If another installed package or an installed feature set depends on the package you are trying to remove, this procedure removes only the dependency from your project manifest. The package itself and all its functionality is still installed in your project, even though it might not appear in the In Project list context. For example, the Show Dependencies setting is disabled by default, so packages that are installed as indirect dependencies don’t appear until you enable this setting. For more information, including an illustrated comparison, see Show Dependencies.

Before you begin

Make 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 the Asset Store, and installing custom packages. Don’t use this procedure to attempt to remove asset packagesA collection of files and data from Unity projects, or elements of projects, which are compressed and stored in one file, similar to Zip files, with the .unitypackage extension. Asset packages are a handy way of sharing and re-using Unity projects and collections of assets. More info
    See in Glossary
    that you downloaded and imported to your project, by using Download and import an asset package. For information about removing asset packages that you downloaded and imported, see Remove imported assets from a project.
  • If 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.

Procedure

To remove an installed package:

  1. Open the Package Manager window and select In Project from the PackagesPackages are collections of assets to be shared and re-used in Unity. The Unity Package Manager (UPM) can display, add, and remove packages from your project. These packages are native to the Unity Package Manager and provide a fundamental method of delivering Unity functionality. However, the Unity Package Manager can also display Asset Store packages that you downloaded from the Asset Store. More info
    See in Glossary
    drop-down menu.

    Switch the context to In Project
    Switch the context to In Project
  2. Select the package you want to remove from the list of packages. The details view now displays that package’s information.

  3. Click the Remove button. If this button is:

    • Not displayed, you might be viewing the My Assets list. See Before you begin.
    • Disabled, you can’t remove this package. Hover over the button to find out why you can’t remove the package. For more information, see Locked and non-removable packages.

    Remove button in the bottom right corner of the details view

    When the progress bar finishes, the package disappears from the list.

  4. 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.

Locked and non-removable packages

You can only remove packages which are 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 view and in the details view. The details view also displays the name of the feature set that requires the package below the package name in the details view.

However, even if you click the Unlock button, you still can’t remove the package from your project until you remove all feature sets which 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 section of the details view. If you don’t need the other packages, you can remove them and the Package Manager automatically removes this package too.

Tip: If you don’t see the Dependencies section, follow these instructions to enable the Show Dependencies setting:

  1. Select Advanced Project Settings under the advanced settings icon.

    Advanced Project Settings opens up the Package Manager project settings window
    Advanced Project Settings opens up the Package Manager project settings window

    The Package Manager project settingsA broad collection of settings which allow you to configure how Physics, Audio, Networking, Graphics, Input and many other areas of your project behave. More info
    See in Glossary
    window appears.

  2. Under the Advanced Settings group, enable the Show Dependencies option.

  3. Close the Project Settings window. Any packages that are only installed as dependencies in your project now appear in the package list and the detail view now displays a Dependencies section.

Additional resources

Install a UPM package by name
Switch to another version of a UPM package