Update Visual Studio

Applies to: yesVisual Studio noVisual Studio for Mac noVisual Studio Code

This topic discusses how to update a client installation of Visual Studio on Windows. For Visual Studio for Mac, see Update Visual Studio for Mac.

If you are an IT Administrator and want to configure your organization's clients to update from a network layout, refer to the Visual Studio Administrators Guide, particularly the section on manage and update a network installation.

Before you update

In order to install, update, or modify Visual Studio, the account performing the update must have administrative permissions on the machine and also must have permissions to the place where the product updates are located (either the internet or a network share). If you are logged in as a typical user and try to perform one of these commands, then you'll get a User Account Control notice prompting you for admin credentials. For more information, see User Permissions and Visual Studio.

Visual Studio must be closed before performing an update. We highly recommend saving your work before performing an update.

Visual Studio must first be installed on the machine before you can update it. To install the current version of Visual Studio from Microsoft hosted servers, go to the Visual Studio downloads page. If you are currently using another instance of Visual Studio, you can either install a new instance of Visual Studio side-by-side to your existing installation, or you can uninstall the previous instance of Visual Studio before installing this new one.

We encourage you to update to the most recent release of Visual Studio 2019 so that you always get the latest features, security fixes, and improvements. And if you'd like to try out our newest version, consider downloading and installing Visual Studio 2022.

There are several different ways to update an installation of Visual Studio. You can update through the Visual Studio Installer, you can check for updates or use the Notification hub in the IDE, or you can update by running a specific version of the bootstrapper. Here's how to update Visual Studio 2019 using these various methods.

Use the Visual Studio Installer

  1. Find the Visual Studio Installer on your computer.

    In the Windows Start menu, you can search for "installer".

    Screenshot showing the result of a Start menu search for the Visual Studio Installer.

    You might have to update the installer before continuing. If so, follow the prompts.

Note

The setup and update features and bug fixes are typically released in the most current version of the installer in the most current release of Visual Studio. This new functionality often just works seamlessley in older versions of the product. For example, in the Visual Studio 2022 version 17.4 installer, we introduced the ability to remove out-of-support components; if this installer is present on a machine that has Visual Studio 2019 installed, the remove out-of-support component functionality would be avilable to that product as well. Instructions for acquiring the latest installer on a machine with an older version of the Visual Studio product are described below.

  1. In the installer, look for the instance of Visual Studio that you want to update.

    For example, if you previously installed Visual Studio Community 2019 and there's an update for it, then an Update available message appears in the installer.

    Screenshot showing a Visual Studio 2019 installation with an available update.

  2. Choose Update to install the updates.

    Screenshot showing the Update button in the Visual Studio installer that can be used to update to a Visual Studio 2019 installation.

  3. After the update is complete, you might be asked to restart your computer. If so, do so, and then start Visual Studio as you typically would.

    If you aren't asked to restart your computer, choose Launch to start Visual Studio from the installer.

    Screenshot showing the Launch button in the Visual Studio installer that can be used to start Visual Studio 2019.

Use the message box in the IDE

  1. When you open Visual Studio is, the IDE checks to see if an update is available. In certain situations, a Visual Studio 2019 update message will briefly appear. If you want to update now, then choose View details. If you want to defer the update until when you close Visual Studio, choose Update on Close.

    Screenshot showing the 'Visual Studio 2019 update' message in the IDE.

  2. If you chose View details, then in the subsequent Update downloaded and ready to install dialog box, choose Update to update now.

    Screenshot showing the Update button in the 'Update downloaded and ready to install' dialog box.

Manually check for updates

  1. You can check to see if an update is available by choosing Help from the menu bar, and then choosing Check for Updates. You can also use the search box by pressing Ctrl+Q, typing "check for updates", and then choosing the search result that matches.

    Screenshot showing the 'Check for Updates' from the Help menu.

  2. In the Update available dialog box, choose Update.

    Screenshot showing the Update button in the 'Update available' dialog box.

Use the Notifications hub

  1. Choose the notification icon from the lower-right corner of the Visual Studio IDE to open the Notifications hub.

    Screenshot showing the notification icon in the Visual Studio IDE.

  2. In the Notifications hub, choose the update that you want to install. If you want to update now, then choose View details. If you want to defer the update until when you close Visual Studio, choose Update on Close.

    Screenshot showing the Notification hub in Visual Studio 2019.

  3. If you chose View details, then in the subsequent Update available dialog box, choose Update.

Run a specific bootstrapper to update the product to a specific version

If you're an Enterprise or Professional customer, you can update your instance of Visual Studio 2019 to any specific version that has been released, as long as it's a higher version than what is currently installed. To update your instance of Visual Studio 2019 via this method, navigate to the Visual Studio 2019 release history page, download the bootstrapper that corresponds to the desired update version into your product installation directory, and then double click on it to initiate the update.

Customize update settings

There are several different settings that can be customized to control the update behavior. A few of these settings are native to Visual Studio 2019 and deal with how and when the product bits are downloaded and installed. Other settings, such as the ability to configure the source of the updates, require the presence of the newer Visual Studio 2022 installer.

Installation and download behaviors

  1. On the menu bar, choose Tools > Options.

  2. Expand Environment, and then choose Product Updates.

    Screenshot showing the updates settings in Visual Studio.

  3. Observe the configuration options that are available to set in this dialog. You can choose the Automatically download updates setting, which allows updates to download while your machine is idle. There are also two installation modes to choose from: Install while downloading, and Download all, then install. Choose the installation mode and the automatic download setting you want for your Visual Studio updates.

Configure source location of updates

If you're in an enterprise environment, then it's possible to configure the location that your client instances look for updates. This is useful in situations where your client installed from a network layout, but you later want the clients to get updates from a different network layout. The ability to configure update locations requires the presence of the newer Visual Studio 2022 installer, which can be obtained by acquiring the latest installer on the client machine, or by an administrator pushing the latest installer out through a network layout. For more information about how to use this feature, refer to the Visual Studio 2022 documentation on configuring source location of updates.

Update on close

In Visual Studio 2019 version 16.9, we introduced the concept of Update on Close. When an update is available, the update notification UI in the IDE provides a way to defer the update to when you voluntarily close Visual Studio. The Update on Close button appears in the update notification message box, and it also can be selected in the notification hub. The Update on Close command is not a permanent setting; it applies only to the current update. In other words, the Update on Close deferral must be chosen each time you acknowledge or dismiss the notification that the update is available.

Screenshot showing the Update on Close option in the update notification message box.

We encourage you to update to the most recent release of Visual Studio 2022 so that you always get the latest features, security fixes, and improvements.

There are several different ways to update an installation of Visual Studio. You can update through the Visual Studio Installer, you can check for updates or use the notification hub in the IDE, or you can update by running a specific version of the bootstrapper. Here's how to update Visual Studio 2022 using these various methods.

Use the Visual Studio Installer

  1. Find the Visual Studio Installer on your computer.

    In the Windows Start menu, search for "installer", and then select Visual Studio Installer from the results.

    Screenshot showing the result of a Start menu search for the Visual Studio Installer.

    If you're prompted to update the Visual Studio Installer before continuing, do so by following the prompts.

Note

The setup and update features and bug fixes are typically released in the most current version of the installer in the most current release of Visual Studio. This new functionality often just works seamlessley in older versions of the product. For example, in the Visual Studio 2022 version 17.4 installer, we introduced the ability to remove out-of-support components; if this installer is present on a machine that has Visual Studio 2019 installed, the remove out-of-support component functionality would be avilable to that product as well. Instructions for acquiring the latest installer on a machine with an older version of the Visual Studio product are described below.

  1. In the Visual Studio Installer, look for the installation of Visual Studio that you want to update.

    For example, if you previously installed Visual Studio Community 2022 and there's an update for it, then an Update available message appears in the Visual Studio Installer.

    Screenshot showing the Update button and message in the Visual Studio Installer when a new update is available.

  2. Choose Update to install the update.

    Screenshot showing the Update button that you can select to install the new update.

  3. After the update is complete, the Visual Studio Installer might prompt you to restart your computer. If so, do so, and then start Visual Studio as you typically would.

    If you aren't asked to restart your computer, choose Launch to start Visual Studio from the Visual Studio Installer.

    Screenshot showing the Launch button that you can select to start Visual Studio.

Use the message box in the IDE

  1. When you open Visual Studio, the IDE checks to see if an update is available. In certain situations, a Visual Studio 2022 update message will briefly appear. If you want to update now, then choose View details. If you want to defer the update until when you close Visual Studio, choose Update on Close.

    Screenshot showing an update message for Visual Studio 2022 in the lower-right corner of the Visual Studio IDE.

  2. If you chose View details, then in the subsequent Update available dialog box, choose Update to update now.

    Screenshot showing the Update button in the 'Update available' dialog box in Visual Studio 2022.

Manually check for updates

  1. You can check to see if an update is available by choosing Help from the menu bar, and then choosing Check for Updates. You can also use the search box by pressing Ctrl+Q, typing "check for updates", and then choosing the search result that matches.

    Screenshot showing the 'Check for Updates' option in the Help menu.

  2. In the Update available dialog box, choose Update.

    Screenshot showing the Update button in the 'Update available' dialog box.

Use the Notifications hub

  1. Choose the notification icon from the lower-right corner of the Visual Studio IDE to open the Notifications hub.

    Screenshot showing the notification icon in the Visual Studio IDE.

  2. In the Notifications hub, choose the update that you want to install. If you want to update now, then choose View details. If you want to defer the update until when you close Visual Studio, choose Update on Close.

    Screenshot showing the Notifications hub in the Visual Studio IDE.

  3. If you chose View details, then in the subsequent Update available dialog box, choose Update.

Run a specific bootstrapper to update the product to a specific version

If you're an Enterprise or Professional customer, you can update your instance of Visual Studio 2022 to any specific version that has been released, as long as it's a higher version than what is currently installed. To update your instance of Visual Studio 2022 via this method, navigate to the Visual Studio 2022 release history page, download the bootstrapper that corresponds to the desired update version into your product installation directory, and then double-click on it to initiate the update.

Customize update settings

There are several different settings that can be customized to control the update behavior, such as how and when the product bits are downloaded and installed, or where the update source location is.

Installation and download behaviors

  1. On the menu bar, choose Tools > Options.

  2. Expand Environment, and then choose Product Updates.

    Screenshot showing the Updates settings in the Options window of the Visual Studio IDE.

  3. Observe the configuration options that are available to set in this dialog. You can choose the Automatically download updates setting, which allows updates to download while your machine is idle. There are also two installation modes to choose from: Install while downloading, and Download all, then install. Choose the installation mode and the automatic download setting you want for your Visual Studio updates.

Configure source location of updates

With Visual Studio 2022, you can now configure where your clients will get their updates from. These update source locations are called "channels", and you can find more information about channel purpose and availability in the Visual Studio Release Rhythm documentation. Microsoft makes both the Current and the Preview channels available to everyone, and the long term servicing channels (LTSCs) are available to Enterprise and Professional customers. IT Administrators can also configure the update source locations, such as network layouts, that the clients should have access to. Refer to the Visual Studio Administrators Guide for additional approach recommendations, and to the modifySettings command documentation for how to access this functionality programmatically.

There are two ways to bring up the Update Settings dialog, which allows you to manually change the channel that your Visual Studio instance should get its updates from.

  1. Open the Visual Studio installer, select the instance you want to configure, choose the More button and then choose the Update settings menu option. Refer to previous instructions for how to find the Visual Studio Installer.

Screenshot showing the Updates settings in the Installer.

  1. An alternative way to invoke the Update Settings dialog is to open the Visual Studio IDE, bring up the Update available dialog (either View details on an update notification or Check for updates on the Help menu) and click on the Change update settings link.

Screenshot showing the Updates settings in the Update available dialog in the IDE.

The Update settings dialog will look something like this. In this example, the Visual studio instance is using the LTSC 17.0 channel.

Screenshot showing the Updates settings dialog in the Visual Studio 2022 IDE.

By choosing the correct value in the Update channel dropdown, you can control the source location of future updates for this instance of Visual Studio. Additional things to keep in mind are:

  • The Preview and Current channels are available for all editions of Visual Studio, and the LTSC channels are only available for Professional and Enterprise customers.
  • You can choose to update your instance of Visual Studio immediately after you configure the Update channel location. Or you can defer the actual product update until some later time. The act of configuring the update channel and the act of updating the product are two independent events. For information on how to programmatically control the update channel, refer to Use the modifySettings command.
  • You can only change the update channel if the version of the product that's available at the tip of that channel is greater than the version you have installed. For example, you can always transition from the Current channel to the Preview channel, but you can't transition from the Preview channel to the Current channel until the latest release on the Current channel surpasses the version of Preview that you have installed.
  • When you update to a new channel, you'll install the most recent release on that channel. If you are an enterprise customer and want to install a particular version of the product on that channel, then follow the Run a specific bootstrapper instructions described previously.
  • LTSC channels all have expiration dates as illustrated in the picture above. Once the LTSC has expired, it cannot be used as a source of updates, and it'll disappear from this list.
  • All Microsoft channels are hosted on Microsoft servers and require access to the internet.
  • Each instance of Visual Studio has the ability to independently configure its source for updates. So, if you have two instances of Visual Studio 2022 installed, each can update from a different channel.
  • IT Administrators can control the text in the Update channel dropdown. For example, they can add network layout locations as update sources. They can also suppress Microsoft hosted locations from being available as update source options. This functionality works for Visual Studio 2019 installs too. For information on how to configure these update locations, refer to the Set defaults for enterprise deployments page.

Update on close

When an update is available, the update notification UI in the IDE provides a way to defer the update until you voluntarily close Visual Studio. The Update on Close button appears in the update notification message box, and it also can be selected in the Notification hub. The Update on Close command is not a permanent setting; it applies only to the current update. In other words, the Update on Close deferral must be chosen each time you acknowledge or dismiss the notification that the update is available.

Screenshot showing the Update on Close option in the update notification message box.

Remove out-of-support components

Using the latest Visual Studio 2022 installer, you can now bulk remove components that have transitioned to an out-of-support state. You can manually remove them by using the installer as described below, you can remove them programmatically, or you can have them removed via machine wide policy. Learn more about removing out-of-support components and how it can help keep your software environment secure.

To bulk remove out-of-support components manually through the UI you can

  1. Open the Visual Studio Installer, and then select Modify.

  2. Select Remove all out-of-support components.

    Screenshot of the Remove out-of-support components option.

All components with an out-of-support label will be deselected and get uninstalled.

You can also configure a specific Visual Studio instance to persistently remove all components that transition to an out-of-support state by selecting the option More> Update Settings> Remove all out-of-support components during future updates in the Visual Studio Installer. Once this setting is configured, any component that transitions to an out-of-support state in the future will be removed during the next Visual Studio update for that instance of Visual Studio.

Screenshot of Remove all out-of-state components during future updates option in the Update Settings dialog.

Install the latest and greatest installer

The most current release of the installer in the latest version of Visual Studio typically has the most robust and reliable feature set. This functionality will often seamlessly work on lower versioned products. In order to manually acquire the latest version of the installer onto a client machine (like if you wanted the functionality of the latest Visual Studio 2022 installer to govern a Visual Studio 2019 installation), you can do one of the following:

  1. Download any bootstrapper for the latest version of Visual Studio and then either

    • Double click on the bootstrapper to initiate the installation. The latest installer will get installed onto the machine first. Once the "Choose Workloads" screen pops up, simply cancel the installation.

    • In a command window, use the bootstrapper to update the installer like this:

      vs_enterprise.exe --update --quiet
      
  2. Download the latest Administrator Update from the Microsoft Update Catalog into the installation directory on your machine. Double click on it to initiate the update, wait for it to update the installer, and then cancel out of the update once the "Choose Workloads" screen pops up.

Administrator updates

If you are part of an organization that centralizes management of software installations, then your enterprise administrator might control how Visual Studio updates your machine. For more about how to control or configure the types of updates your machine can accept, see Using Configuration Manager to deploy Visual Studio updates.

Update from the Microsoft Catalog

You can download an Administrator Update from the Microsoft Update Catalog into the installation directory on your machine, and use it to update your installation by just double-clicking on it to apply the update.

Support or troubleshooting

Sometimes, things can go wrong. If your Visual Studio installation fails, see Troubleshoot Visual Studio installation and upgrade issues for step-by-step guidance.

Here are a few more support options:

  • We offer an installation chat (English only) support option for installation-related issues.
  • Report product issues to us via the Report a Problem tool that appears both in the Visual Studio Installer and in the Visual Studio IDE. If you're an IT Administrator and don't have Visual Studio installed, you can submit IT Admin feedback here.
  • Suggest a feature, track product issues, and find answers in the Visual Studio Developer Community.

See also