Skip to content

Commit 9fe46e0

Browse files
committed
initial edits
1 parent 63d4685 commit 9fe46e0

1 file changed

Lines changed: 34 additions & 11 deletions

File tree

support/developer/visualstudio/installation/troubleshoot-installation-issues.md

Lines changed: 34 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,7 @@
22
title: Troubleshoot installation and upgrade issues
33
description: Introduces resolutions for common issues with Visual Studio installation and upgrade.
44
ms.date: 11/4/2025
5-
author: aartig13
6-
ms.author: aartigoyle
7-
ms.reviewer: meghaanand, v-jayaramanp, jagbal
5+
ms.reviewer: meghaanand, v-jayaramanp, jagbal, v-shaywood
86
ms.custom: sap:Installation\Setup, maintenance, or uninstall
97
---
108

@@ -25,7 +23,11 @@ Try the following possible resolutions that apply to a typical online installati
2523

2624
The first thing to check is whether or not the issue you're encountering is a known issue with the Visual Studio Installer that Microsoft is working on fixing.
2725

28-
To see if there's a workaround for your problem, check [Known Issues of Visual Studio](/visualstudio/releases/2026/release-notes#-known-issues)
26+
To see if there's a workaround for your problem, check:
27+
28+
- [Known Issues of Visual Studio 2026](/visualstudio/releases/2026/release-notes#-known-issues)
29+
- [Known Issues of Visual Studio 2022](/visualstudio/releases/2022/release-notes#-known-issues)
30+
- [Known Issues of Visual Studio 2019](/visualstudio/releases/2019/release-notes#-known-issues)
2931

3032
#### 2. Try repairing Visual Studio
3133

@@ -41,7 +43,9 @@ If you encountered an issue when updating, try deleting the Visual Studio Instal
4143

4244
1. Close the Visual Studio Installer.
4345
1. Delete the Visual Studio Installer folder. Typically, the folder path is _C:\Program Files (x86)\Microsoft Visual Studio\Installer_.
44-
1. Run the Visual Studio Installer bootstrapper. You can get the bootstrapper from the [downloads page](https://visualstudio.microsoft.com/downloads), for previous bootstrapper versions see the [older downloads page](https://visualstudio.microsoft.com/vs/older-downloads), you can also find the bootstrapper manually in your _Downloads_ folder with a file name _VisualStudioSetup.exe_, for VIsual Studio 2019 and earlier _vs\_\<edition>*.exe_. Then, run the executable to reset your installation metadata.
46+
1. Run the Visual Studio Installer bootstrapper.
47+
1. You can get the bootstrapper for the latest version of Visual Studio from the [downloads page](https://visualstudio.microsoft.com/downloads), for previous Visual Studio versions see the [older downloads page](https://visualstudio.microsoft.com/vs/older-downloads).
48+
1. You can also find the bootstrapper in your _Downloads_ folder. The bootstrapper will be named `VisualStudioSetup.exe` for Visual Studio 2022 and later, or `vs_<edition>.exe` for Visual Studio 2019 and earlier.
4549
1. Try to install or update Visual Studio again. If the Visual Studio Installer continues to fail, [report a problem to support](#5-report-the-problem-to-support).
4650

4751
#### 5. Report the problem to support
@@ -50,6 +54,8 @@ In some situations, when there are corrupted files, issues might require case-by
5054

5155
Follow these steps to submit the problem to Microsoft Support:
5256

57+
##### Visual Studio 2022 and later
58+
5359
1. Collect your setup logs. See [How to get the Visual Studio installation logs](#collect-installation-logs-for-microsoft-support) for details.
5460
1. Open the Visual Studio Installer, and then choose **Report a problem** to open the Visual Studio Feedback tool.
5561

@@ -58,22 +64,33 @@ Follow these steps to submit the problem to Microsoft Support:
5864
1. Give your problem report a title, and provide the relevant details. The most recent setup log for the Visual Studio Installer is automatically added to the **Additional attachments** section of your problem report.
5965
1. Choose **Submit**.
6066

67+
##### Visual Studio 2019 and earlier
68+
69+
1. Collect your setup logs. See [How to get the Visual Studio installation logs](#collect-installation-logs-for-microsoft-support) for details.
70+
1. Open the Visual Studio Installer, and then select **Report a problem** to open the Visual Studio Feedback tool.
71+
1. Give your problem report a title, and provide relevant details. Select **Next** to go to the **Attachments** section, and then attach the generated log file (typically, the file is at `%TEMP%\vslogs.zip`).
72+
1. Select **Next** to review your problem report, and then select **Submit**.
73+
6174
#### 6. Remove all Visual Studio installation files
6275

6376
As a last resort, you can remove all Visual Studio installation files and product information:
6477

6578
1. [Remove all with InstallCleanup.exe](/visualstudio/install/uninstall-visual-studio#remove).
66-
1. Rerun the Visual Studio Installer bootstrapper. You can get the bootstrapper from the [download page](https://visualstudio.microsoft.com/downloads), for previous bootstrapper versions see the [older downloads page](https://visualstudio.microsoft.com/vs/older-downloads), you can also find the bootstrapper manually in your _Downloads_ folder with a file name _VisualStudioSetup.exe_ or _vs\_\<edition>*.exe_. Then, run the executable to reset your installation metadata.
79+
1. Rerun the Visual Studio Installer bootstrapper.
80+
1. You can get the bootstrapper for the latest version of Visual Studio from the [downloads page](https://visualstudio.microsoft.com/downloads), for previous Visual Studio versions see the [older downloads page](https://visualstudio.microsoft.com/vs/older-downloads).
81+
1. You can also find the bootstrapper in your _Downloads_ folder. The bootstrapper will be named `VisualStudioSetup.exe` for Visual Studio 2022 and later, or `vs_<edition>.exe` for Visual Studio 2019 and earlier.
6782
1. Try to reinstall Visual Studio.
6883

69-
#### 7. Rollback to a previous install
84+
#### 7. Rollback to a previous install (Visual Studio 2022 and newer)
85+
86+
If none of the previous steps helped you successfully update Visual Studio, you can rollback to your previously installed version by using the Visual Studio Installer or the command line.
7087

71-
If none of the previous steps helped you successfully update Visual Studio, you can rollback to your previously installed version by using the Visual Studio Installer or the command line.
88+
Since Visual Studio 2022 version 17.4, you can roll back to your previously installed version if your original version was on the current channel version 17.1.7 or higher, or on the 17.0 Fall 2021 LTSC channel 17.0.10 or higher.
7289

7390
> [!IMPORTANT]
7491
> If you're in an organization and are using a layout to update Visual Studio, your IT Administrator is expected to maintain the previous packages in the layout if the client is expected to be able to roll back. Also, rollback may be disabled or your rollback attempt may be undone if you're in an organization that has security compliance or software updating requirements. Contact your IT Administrator for further details.
7592
76-
To rollback with the Visual Studio Installer, follow these steps:
93+
##### Rollback using the Visual Studio Installer
7794

7895
1. Launch the **Visual Studio Installer** on your computer.
7996
1. In the installer, look for the edition of Visual Studio that you installed.
@@ -83,9 +100,15 @@ To rollback with the Visual Studio Installer, follow these steps:
83100
:::image type="content" source="media/troubleshoot-installation-issues/rollback-from-previous-version.png" alt-text="Screenshot of the Rollback to previous version option." lightbox="media/troubleshoot-installation-issues/rollback-from-previous-version.png":::
84101
1. Select **OK** to confirm.
85102

86-
To rollback with the command line:
103+
##### Rollback using the command line
104+
105+
You can rollback the update programmatically by using the installer on the client machine and passing in the rollback command alongside the installation path instance. For example:
106+
107+
```powershell
108+
VisualStudioSetup.exe rollback --installPath <VisualStudioInstallPath>
109+
```
87110

88-
You can rollback the update programmatically by using the installer on the client machine and passing in the rollback command alongside the installation path instance. For more information, visit [Use command-line parameters to install Visual Studio](/visualstudio/install/use-command-line-parameters-to-install-visual-studio)
111+
For more information, see [Use command-line parameters to install Visual Studio](/visualstudio/install/use-command-line-parameters-to-install-visual-studio)
89112

90113
#### 8. Contact our live chat
91114

0 commit comments

Comments
 (0)