NuGet Package Manager UI

The NuGet Package Manager UI in Visual Studio on Windows allows you to easily install, uninstall, and update NuGet packages in projects and solutions. For the experience in Visual Studio for Mac, see Including a NuGet package in your project.

In this topic:

Note

If you're missing the NuGet Package Manager in Visual Studio 2015, check Tools > Extensions and Updates... and search for the NuGet Package Manager extension. If you're unable to use the extensions installer in Visual Studio, download the extension directly from https://dist.nuget.org/index.html.

In Visual Studio 2017, NuGet and the NuGet Package Manager are automatically installed with any .NET-related workloads. Install it individuall by selecting the Individual components > Code tools > NuGet package manager option in the Visual Studio 2017 installer.

Finding and installing a package

  1. In Solution Explorer, right-click either References or a project and select Manage NuGet Packages....

    Manage NuGet Packages menu option

  2. The Browse tab displays packages by popularity from the currently selected source (see package sources). Search for a specific package using the search box on the upper left. Select a package from the list to display its information, which also enables the Install button along with a version-selection drop-down.

    Manage NuGet Packages Dialog Browse tab

  3. Select the desired version from the drop-down and select Install. Visual Studio installs the package and its dependencies into the project. You may be asked to accept license terms. When installation is complete, the added packages appear on the Installed tab. Packages are also listed in the References node of Solution Explorer, indicating that you can refer to them in the project with using statements.

    References in Solution Explorer

Tip

To include prerelease versions in the search, and to make prerelease versions available in the version drop-down, select the Include prerelease option.

Uninstalling a package

  1. In Solution Explorer, right-click either References or the desired project, and select Manage NuGet Packages....
  2. Select the Installed tab.
  3. Select the package to uninstall (using search to filter the list if necessary) and select Uninstall.

    Uninstalling a package

  4. Note that the Include preprelease and Package source controls have no effect when uninstalling packages.

Updating a package

  1. In Solution Explorer, right-click either References or the desired project, and select Manage NuGet Packages.... (In web site projects, right-click the Bin folder.)
  2. Select the Updates tab to see packages that have available updates from the selected package sources. Select Include prerelease to include prerelease packages in the update list.
  3. Select the package to update, select the desired version from the drop-down on the right, and select Update.

    Updating a package

  4. For some packages, the Update button is disabled and a message appears saying that it's "Implicitly referenced by an SDK" (or "AutoReferenced"). The message indicates that the package, such as Microsoft.NETCore.App or Microsoft.NETStandard.Library, is part of a larger framework or SDK and should not be updated independently. (Such packagee are internally marked with <IsImplicitlyDefined>True</IsImplicitlyDefined>.) To update the package, update the SDK to which it belongs.

    Example package marked as Implicitly references or AutoReferenced

  5. To update multiple packages to their newest versions, select them in the list and select the Update button above the list.

  6. You can also update an individual package from the Installed tab. In this case, the details for the package include a version selector (subject to the Include prerelease option) and an Update button.

Managing packages for the solution

Managing packages for a solution is a convenient means to work with multiple projects simultaneously.

  1. Select the Tools > NuGet Package Manager > Manage NuGet Packages for Solution... menu command, or right-click the solution and select Manage NuGet Packages...:

    Manage NuGet packages for the solution

  2. When managing packages for the solution, the UI lets you select the projects that are affected by the operations:

    Project selector when managing packages for the solution

Package sources

To change the source from which Visual Studio obtains packages, select one from the source selector:

Package source selector in the package manager UI

To manage package sources:

  1. Select the Settings icon in the Package Manager UI outlined below or use the Tools > Options command and scroll to NuGet Package Manager:

    Package manager UI settings icon

  2. Select the Package Sources node:

    Package Sources options

  3. To add a source, select +, edit the name, enter the URL or path in the Source control, and select Update. The source now appears in the selector drop-down.

  4. To change a package source, select it, make edits in the Name and Source boxes, and select Update.
  5. To disable a package source, clear the box to the left of the name in the list.
  6. To remove a package source, select it and then select the X button.
  7. Use the up and down arrow buttons to change the priority order of the package sources. Visual Studio searches these sources in the priority order when restoring packages for a project. For more information, see Package restore.

Tip

If a package source reappears after deleting it, it may be listed in a computer-level or user-level NuGet.Config files. See Configuring NuGet behavior for the location of these files, then remove the source by editing the files manually or using the nuget sources command.

Package manager Options control

When a package is selected, the Package Manager UI displays a small, expandable Options control below the version selector (shown here both collapsed and expanded):

Package manager options

The following sections explain these options.

Show preview window

When selected, a modal window displays which the dependencies of a chosen package before the package is installed:

Example Preview Dialog

Install and Update Options

Dependency behavior configures how NuGet decides which versions of dependent packages to install:

  • Ignore dependencies skips installing any dependencies, which typically breaks the package being installed.
  • Lowest [Default] installs the dependency with the minimal version number that meets the requirements of the primary chosen package.
  • Highest Patch installs the version with the same major and minor version numbers, but the highest patch number. For example, if version 1.2.2 is specified then the highest version that starts with 1.2 will be installed
  • Highest Minor installs the version with the same major version number but the highest minor number and patch number. If version 1.2.2 is specified, then the highest version that starts with 1 will be installed
  • Highest installs the highest available version of the package.

File conflict action specifies how NuGet should handle packages that already exist in the project or local machine:

  • Prompt instructs NuGet to ask whether to keep or overwrite existing packages.
  • Ignore All instructs NuGet to skip overwriting any existing packages.
  • Overwrite All instructs NuGet to overwrite any existing packages.

Uninstall Options

Remove dependencies: when selected, removes any dependent packages if they're not referenced elsewhere in the project.

Force uninstall even if there are dependencies on it: when selected, uninstalls a package even if it's still being referenced in the project. This is typically used in combination with Remove dependencies to remove a package and whatever dependencies it installed. Using this option may, however, lead to a broken references in the project. In such cases you may need to reinstall those other packages.