Skip to content

Commit 5e4b6e4

Browse files
authored
Update troubleshoot-installation-issues.md
Edit review per CI 8270
1 parent d4fcf4b commit 5e4b6e4

1 file changed

Lines changed: 56 additions & 60 deletions

File tree

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

Lines changed: 56 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Troubleshoot installation and upgrade issues
3-
description: Introduces resolutions for common issues with Visual Studio installation and upgrade.
2+
title: Troubleshoot Installation and Upgrade Issues
3+
description: Introduces resolutions for common issues that affect Visual Studio installation and upgrade.
44
ms.date: 11/4/2025
55
ms.reviewer: meghaanand, v-jayaramanp, jagbal, v-shaywood
66
ms.custom: sap:Installation\Setup, maintenance, or uninstall
@@ -10,149 +10,145 @@ ms.custom: sap:Installation\Setup, maintenance, or uninstall
1010

1111
_Applies to:_ Visual Studio
1212

13-
This troubleshooting guide includes step-by-step instructions to resolve common issues with Visual Studio installation and upgrade.
13+
This article includes step-by-step instructions to resolve common issues that affect the installation and upgrade of Microsoft Visual Studio.
1414

1515
> [!TIP]
1616
> Having a problem installing? We can help. We offer an [**installation chat**](https://visualstudio.microsoft.com/vs/support/#talktous) (English only) support option.
1717
1818
## Online installations or updates
1919

20-
Try the following possible resolutions that apply to a typical online installation issue in order.
20+
To troubleshoot issues that affect a typical online installation issue, try the following possible resolutions in the given order.
2121

22-
#### 1. Check whether the problem is a known issue
22+
#### Check whether the problem is a known issue
2323

24-
Check if the issue you're encountering is a known issue with the Visual Studio Installer that Microsoft is working on fixing.
25-
26-
To see if there's a workaround for your problem, check:
24+
To check whether you're experiencing a known issue in the Visual Studio Installer that Microsoft is actively working on fixing, visit the following websites:
2725

2826
- [Known Issues of Visual Studio 2026](/visualstudio/releases/2026/release-notes#-known-issues)
2927
- [Known Issues of Visual Studio 2022](/visualstudio/releases/2022/release-notes#-known-issues)
3028
- [Known Issues of Visual Studio 2019](/visualstudio/releases/2019/release-notes#-known-issues)
3129

32-
#### 2. Try repairing Visual Studio
30+
#### Try to repair Visual Studio
3331

34-
Try to [repair your installation](/visualstudio/install/repair-visual-studio). It might fix many common update issues.
32+
Try to [repair your installation](/visualstudio/install/repair-visual-studio). A repair might fix many common update issues.
3533

36-
#### 3. See what the developer community says about the error
34+
#### Learn what the developer community says about the error
3735

38-
If repairing didn't fix the issue, search for your error message in the [Visual Studio Developer Community](https://developercommunity.visualstudio.com/search?space=8). Other members of the community might have found a solution or workaround to your problem.
36+
If a repair doesn't fix your issue, search for your error message in the [Visual Studio Developer Community](https://developercommunity.visualstudio.com/search?space=8). Other members of the community might have found a solution or workaround to your problem.
3937

40-
#### 4. Delete the installer folder (update issues)
38+
#### Delete the Installer folder (update issues)
4139

42-
If you encounter an issue when updating, try deleting the Visual Studio Installer folder, then rerun the installation bootstrapper. This action can solve certain update failures. It reinstalls the Visual Studio Installer files and resets the installation metadata.
40+
If you encounter an issue when you try to update the program, try deleting the Visual Studio Installer folder, and then rerun the installation bootstrapper. This action can solve certain update failures. It reinstalls the Visual Studio Installer files and resets the installation metadata. To delete the folder, follow these steps:
4341

4442
1. Close the Visual Studio Installer.
4543
1. Delete the Visual Studio Installer folder. Typically, the folder path is _C:\Program Files (x86)\Microsoft Visual Studio\Installer_.
4644
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 is named `VisualStudioSetup.exe` for Visual Studio 2022 and later, or `vs_<edition>.exe` for Visual Studio 2019 and earlier.
49-
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).
50-
51-
#### 5. Report the problem to support
45+
- 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).
46+
- You can also find the bootstrapper in your _Downloads_ folder. The bootstrapper is named `VisualStudioSetup.exe` for Visual Studio 2022 and later, or `vs_<edition>.exe` for Visual Studio 2019 and earlier.
47+
1. Try again to install or update Visual Studio. If the Visual Studio Installer continues to fail, go to the next section.
5248

53-
In some situations, corrupted files cause issues that require case-by-case troubleshooting.
49+
#### 5. Report the problem to Microsoft Support
5450

55-
Follow these steps to submit the problem to Microsoft Support:
51+
In some situations, corrupted files cause issues that require case-by-case troubleshooting. Follow the appropriate steps for your version of Visual Studio.
5652

5753
##### [Visual Studio 2022 and later](#tab/vs-2022-older)
5854

59-
1. Collect your setup logs. See [How to get the Visual Studio installation logs](#collect-installation-logs-for-microsoft-support) for details.
60-
1. Open the Visual Studio Installer, then choose **Report a problem** to open the Visual Studio Feedback tool.
55+
1. Collect your setup logs. For details, see [How to get the Visual Studio installation logs](#collect-installation-logs-for-microsoft-support).
56+
1. Open the Visual Studio Installer. Then, select **Report a problem** to open the Visual Studio Feedback tool.
6157

62-
:::image type="content" source="media/troubleshoot-installation-issues/vs-installer-report-problem.png" alt-text="Screenshot showing the Provide feedback button in the Visual Studio Installer." lightbox="media/troubleshoot-installation-issues/vs-installer-report-problem.png":::
58+
:::image type="content" source="media/troubleshoot-installation-issues/vs-installer-report-problem.png" alt-text="The Provide feedback button in the Visual Studio Installer." lightbox="media/troubleshoot-installation-issues/vs-installer-report-problem.png":::
6359

6460
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.
65-
1. Choose **Submit**.
61+
1. Select **Submit**.
6662

6763
##### [Visual Studio 2019 and earlier](#tab/vs-2019-earlier)
6864

69-
1. Collect your setup logs. See [How to get the Visual Studio installation logs](#collect-installation-logs-for-microsoft-support) for details.
65+
1. Collect your setup logs. For details, see [How to get the Visual Studio installation logs](#collect-installation-logs-for-microsoft-support).
7066

71-
1. Open the Visual Studio Installer, then select **Report a problem** to open the Visual Studio Feedback tool.
67+
1. Open the Visual Studio Installer. Then, select **Report a problem** to open the Visual Studio Feedback tool.
7268

73-
1. Give your problem report a title, and provide relevant details. Select **Next** to go to the **Attachments** section, then attach the generated log file (typically, the file is at `%TEMP%\vslogs.zip`).
69+
1. Give your problem report a title, and provide the relevant details.
7470

75-
1. Select **Next** to review your problem report, then select **Submit**.
71+
1. Select **Next** to go to the **Attachments** section, then attach the generated log file (typically, the file is located at `%TEMP%\vslogs.zip`).
7672

77-
---
73+
1. Select **Next** to review your problem report, then select **Submit**.
7874

79-
#### 6. Remove all Visual Studio installation files
75+
#### Remove all Visual Studio installation files
8076

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

83-
1. [Remove all with InstallCleanup.exe](/visualstudio/install/uninstall-visual-studio#remove).
79+
1. [Remove all files by using InstallCleanup.exe](/visualstudio/install/uninstall-visual-studio#remove).
8480
1. Rerun the Visual Studio Installer bootstrapper.
85-
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).
86-
1. You can also find the bootstrapper in your _Downloads_ folder. The bootstrapper is named `VisualStudioSetup.exe` for Visual Studio 2022 and later, or `vs_<edition>.exe` for Visual Studio 2019 and earlier.
87-
1. Try to reinstall Visual Studio.
81+
- 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).
82+
- You can also find the bootstrapper in your _Downloads_ folder. The bootstrapper is named `VisualStudioSetup.exe` for Visual Studio 2022 and later, or `vs_<edition>.exe` for Visual Studio 2019 and earlier.
83+
1. Try again to reinstall Visual Studio.
8884

89-
#### 7. Rollback to a previous install (Visual Studio 2022 and newer)
85+
#### 7. Roll back to a previous install (Visual Studio 2022 and later)
9086

91-
If none of the previous steps help you successfully update Visual Studio, you can rollback to your previously installed version by using the Visual Studio Installer or the command line.
87+
If none of the previous steps help you to successfully update Visual Studio, you can roll back the program to your previously installed version by using the Visual Studio Installer or the command line.
9288

9389
> [!IMPORTANT]
94-
> 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 might be disabled or your rollback attempt might be undone if you're in an organization that has security compliance or software updating requirements. Contact your IT Administrator for further details.
90+
> If you're in an organization, and you use 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, the rollback process might be disabled or your rollback attempt might be undone if you're in an organization that has security compliance or software updating requirements. Contact your IT Administrator for more details.
9591
96-
##### Rollback using the Visual Studio Installer
92+
##### Roll back by using the Visual Studio Installer
9793

98-
1. Launch the **Visual Studio Installer** on your computer.
99-
1. In the installer, look for the edition of Visual Studio that you installed.
94+
1. Start **Visual Studio Installer** on your computer.
95+
1. In the installer, look for the edition of Visual Studio that you have installed.
10096
1. Select **More**.
10197
1. Select **Rollback to previous version**.
10298

103-
:::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":::
104-
1. Select **OK** to confirm.
99+
:::image type="content" source="media/troubleshoot-installation-issues/rollback-from-previous-version.png" alt-text="Option to roll back to a previous program version." lightbox="media/troubleshoot-installation-issues/rollback-from-previous-version.png":::
100+
1. To confirm the action, select **OK**.
105101

106-
##### Rollback using the command line
102+
##### Roll back by using the command line
107103

108-
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:
104+
You can roll back the update programmatically by using the installer on the client computer and passing in the rollback command alongside the installation path instance. For example:
109105

110106
```powershell
111107
VisualStudioSetup.exe rollback --installPath <VisualStudioInstallPath>
112108
```
113109

114110
For more information, see [Use command-line parameters to install Visual Studio](/visualstudio/install/use-command-line-parameters-to-install-visual-studio).
115111

116-
#### 8. Contact our live chat
112+
#### Contact our live chat
117113

118-
If none of the previous steps help you successfully install or upgrade Visual Studio, contact us by using our [**live chat**](https://visualstudio.microsoft.com/vs/support/#talktous) support option (English only) for further assistance.
114+
If none of the previous resolutions help you successfully install or upgrade Visual Studio, contact us by using our [**live chat**](https://visualstudio.microsoft.com/vs/support/#talktous) support option (English only) for more assistance.
119115

120116
## Network layout or offline installations
121117

122-
To resolve issues with a [network installation](/visualstudio/install/create-a-network-installation-of-visual-studio), see [Error Codes](/visualstudio/install/create-a-network-installation-of-visual-studio#error-codes) or [Troubleshoot network-related errors when you install or use Visual Studio](troubleshoot-network-related-errors.md).
118+
To resolve issues that affect a [network installation](/visualstudio/install/create-a-network-installation-of-visual-studio), see [Error Codes](/visualstudio/install/create-a-network-installation-of-visual-studio#error-codes) or [Troubleshoot network-related errors when you install or use Visual Studio](troubleshoot-network-related-errors.md).
123119

124120
## Administrator updates
125121

126-
Various situations can prevent administrator updates from applying correctly. For more information, see [Administrator updates troubleshooting error codes](/visualstudio/install/applying-administrator-updates#verification-reports-and-troubleshooting-error-codes).
122+
Various situations can prevent administrator updates from applying correctly. For more information, see [Administrator updates troubleshooting error codes](/visualstudio/install/applying-administrator-updates#veris-and-troubleshooting-error-codefication-reports).
127123

128-
Use the following methods to provide feedback about Visual Studio administrator updates or report issues that affect the updates:
124+
To provide feedback about Visual Studio administrator updates, or to report issues that affect the updates, use the following methods:
129125

130-
- Ask questions to the community at the [Visual Studio Setup Q&A Forum](/answers/topics/vs-setup.html).
126+
- Ask questions of the user community at the [Visual Studio Setup Q&A Forum](/answers/topics/vs-setup.html).
131127
- Go to the [Visual Studio support page](https://visualstudio.microsoft.com/vs/support/), and check whether your issue is listed in the FAQ.
132-
- [Provide feature feedback or report a problem](https://aka.ms/vs/wsus/feedback) to the Visual Studio team regarding your experience.
133-
- Contact your organization's technical account manager for Microsoft.
128+
- [Provide feature feedback or report a problem](https://aka.ms/vs/wsus/feedback) to the Visual Studio team about your experience.
129+
- Contact your organization's technical accounts manager for Microsoft.
134130

135131
## Collect installation logs for Microsoft Support
136132

137-
If you contact Microsoft Support, they might ask you to collect setup logs by using the [Microsoft Visual Studio and .NET Framework log collection tool](https://aka.ms/vscollect). The log collection tool collects setup logs from all components installed by Visual Studio, including .NET Framework, Windows SDK, and SQL Server. It also collects computer information, a Windows Installer inventory, and Windows event log information for the Visual Studio Installer, Windows Installer, and System Restore.
133+
A Microsoft Support agent might ask you to collect setup logs by using the [Microsoft Visual Studio and .NET Framework log collection tool](https://aka.ms/vscollect). The log collection tool collects setup logs from all components that are installed by Visual Studio, including .NET Framework, Windows SDK, and SQL Server. It also collects computer information, a Windows Installer inventory, and Windows event log information for the Visual Studio Installer, Windows Installer, and System Restore.
138134

139135
To collect the logs, follow these steps:
140136

141137
1. [Download the tool](https://aka.ms/vscollect).
142-
1. Open an administrative command prompt.
138+
1. Open an elevated Command Prompt window.
143139
1. Run `Collect.exe` in the folder where you saved the tool.
144140

145-
You must run the tool under the same user account that you used for the failed installation. If you run the tool from a different user account, set the `-user:<name>` option to specify the user account for the failed installation. Run `Collect.exe -?` from an administrator command prompt for more options and usage information.
141+
You must run the tool under the same user account that you used for the failed installation attempt. If you run the tool from a different user account, set the `-user:<name>` option to specify the user account for the failed installation. For more options and usage information, run `Collect.exe -?` at an elevated command prompt.
146142

147-
The tool generates a _vslogs.zip_ file in your _%TEMP%_ folder, typically at _C:\Users\YourName\AppData\Local\Temp\vslogs.zip_.
143+
The collection tool generates a _vslogs.zip_ file in your _%TEMP%_ folder, typically at _C:\Users\YourName\AppData\Local\Temp\vslogs.zip_.
148144

149-
Report product issues by using the [Report a Problem](/visualstudio/ide/how-to-report-a-problem-with-visual-studio) 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](https://aka.ms/vs/admin/feedback).
145+
Report product issues by using the [Report a Problem](/visualstudio/ide/how-to-report-a-problem-with-visual-studio) tool that appears both in the Visual Studio Installer and in the Visual Studio IDE. If you're an IT administrator, and you don't have Visual Studio installed, you can submit [IT admin feedback here](https://aka.ms/vs/admin/feedback).
150146

151147
## Problems installing WebView2
152148

153-
If your organization's Group policies block the installation of the WebView2 component, you can't install Visual Studio because the installer requires WebView2. If this issue occurs, check these policies:
149+
If your organization's Group Policy settings block the installation of the WebView2 component, you can't install Visual Studio because the installer requires WebView2. If this issue occurs, check these policies:
154150

155-
- If the [Microsoft Edge 'Install (WebView)'](/deployedge/microsoft-edge-update-policies#install-webview) policy is configured, it determines whether WebView2 can be installed.
151+
- If the [Microsoft Edge 'Install (WebView)'](/deployedge/microsoft-edge-update-policies#install-webview) policy is configured, that policy determines whether WebView2 can be installed.
156152
- If the _Microsoft Edge 'Install (WebView)' policy_ isn't configured, the [Microsoft Edge 'InstallDefault'](/deployedge/microsoft-edge-update-policies#installdefault) policy determines whether WebView2 can be installed.
157153

158154
> [!WARNING]

0 commit comments

Comments
 (0)