You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
ms.custom: sap:Installation\Setup, maintenance, or uninstall
@@ -10,149 +10,145 @@ ms.custom: sap:Installation\Setup, maintenance, or uninstall
10
10
11
11
_Applies to:_ Visual Studio
12
12
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.
14
14
15
15
> [!TIP]
16
16
> Having a problem installing? We can help. We offer an [**installation chat**](https://visualstudio.microsoft.com/vs/support/#talktous) (English only) support option.
17
17
18
18
## Online installations or updates
19
19
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.
21
21
22
-
#### 1. Check whether the problem is a known issue
22
+
#### Check whether the problem is a known issue
23
23
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:
27
25
28
26
-[Known Issues of Visual Studio 2026](/visualstudio/releases/2026/release-notes#-known-issues)
29
27
-[Known Issues of Visual Studio 2022](/visualstudio/releases/2022/release-notes#-known-issues)
30
28
-[Known Issues of Visual Studio 2019](/visualstudio/releases/2019/release-notes#-known-issues)
31
29
32
-
#### 2. Try repairing Visual Studio
30
+
#### Try to repair Visual Studio
33
31
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.
35
33
36
-
#### 3. See what the developer community says about the error
34
+
#### Learn what the developer community says about the error
37
35
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.
39
37
40
-
#### 4. Delete the installer folder (update issues)
38
+
#### Delete the Installer folder (update issues)
41
39
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:
43
41
44
42
1. Close the Visual Studio Installer.
45
43
1. Delete the Visual Studio Installer folder. Typically, the folder path is _C:\Program Files (x86)\Microsoft Visual Studio\Installer_.
46
44
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.
52
48
53
-
In some situations, corrupted files cause issues that require case-by-case troubleshooting.
49
+
#### 5. Report the problem to Microsoft Support
54
50
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.
56
52
57
53
##### [Visual Studio 2022 and later](#tab/vs-2022-older)
58
54
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.
61
57
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":::
63
59
64
60
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**.
66
62
67
63
##### [Visual Studio 2019 and earlier](#tab/vs-2019-earlier)
68
64
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).
70
66
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.
72
68
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.
74
70
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`).
76
72
77
-
---
73
+
1. Select **Next** to review your problem report, then select **Submit**.
78
74
79
-
#### 6. Remove all Visual Studio installation files
75
+
#### Remove all Visual Studio installation files
80
76
81
77
As a last resort, you can remove all Visual Studio installation files and product information:
82
78
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).
84
80
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.
88
84
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)
90
86
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.
92
88
93
89
> [!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.
95
91
96
-
##### Rollback using the Visual Studio Installer
92
+
##### Roll back by using the Visual Studio Installer
97
93
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.
100
96
1. Select **More**.
101
97
1. Select **Rollback to previous version**.
102
98
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**.
105
101
106
-
##### Rollback using the command line
102
+
##### Roll back by using the command line
107
103
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:
For more information, see [Use command-line parameters to install Visual Studio](/visualstudio/install/use-command-line-parameters-to-install-visual-studio).
115
111
116
-
#### 8. Contact our live chat
112
+
#### Contact our live chat
117
113
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.
119
115
120
116
## Network layout or offline installations
121
117
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).
123
119
124
120
## Administrator updates
125
121
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).
127
123
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:
129
125
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).
131
127
- 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.
134
130
135
131
## Collect installation logs for Microsoft Support
136
132
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.
138
134
139
135
To collect the logs, follow these steps:
140
136
141
137
1.[Download the tool](https://aka.ms/vscollect).
142
-
1. Open an administrative command prompt.
138
+
1. Open an elevated Command Prompt window.
143
139
1. Run `Collect.exe` in the folder where you saved the tool.
144
140
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.
146
142
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_.
148
144
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).
150
146
151
147
## Problems installing WebView2
152
148
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:
154
150
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.
156
152
- 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.
0 commit comments