Update Visual Studio

Applies to: Visual Studio Visual Studio for Mac Visual 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 source where the product updates are located (either the internet or an internal location). 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 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.

   

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

Note

Visual Studio setup features and bug fixes are typically implemented in the installer. The installer is now shipping in the most current release of all currently supported Visual Studio products. This means that in general (unless otherwise specified), all new setup functionality often just works seamlessly in older versions of the product.

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.

   

2. Choose Update to install the 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.

   

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.

   

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

   

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.

   

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

   

Use the Notifications hub

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

   

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.

   

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.

   

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.

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

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

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.

Always update on close

In Visual Studio 2022, you can configure Visual Studio to automatically apply available updates on close. This setting is configurable on a per instance basis of Visual Studio. For example, you can set your Preview instance to apply updates when Visual Studio closes, but your other Visual Studio instances can continue to be updated on demand. You can configure this setting in the Tools > Options > Product Updates > Update settings dialog.

After you configure Visual Studio to always update on close, Visual Studio updates will begin once Visual Studio and all related processes are closed. If any extensions have been scheduled for install or update, the Visual Studio update will not start until the next time Visual Studio closes.

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.

   

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.

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

• Install Visual Studio versions side-by-side
• Update a network-based installation of Visual Studio
• Visual Studio administrator guide
• Control updates to network-based Visual Studio deployments
• Modify Visual Studio
• Uninstall Visual Studio