dotnet · adegeo · Mar 19, 2026 · Mar 19, 2026 · Mar 19, 2026 · Mar 19, 2026
@@ -1,7 +1,7 @@
 ---
 author: adegeo
 ms.author: adegeo
-ms.date: 11/07/2025
+ms.date: 03/19/2026
 ms.topic: include
 ---
 

@@ -4,7 +4,7 @@ description: "Describes how the code analysis function of .NET Upgrade Assistant
 author: adegeo
 ms.author: adegeo
 ms.topic: overview
-ms.date: 10/08/2024
+ms.date: 03/19/2026
 
 #customer intent: As a developer, I need to understand what the analyze function of .NET Upgrade Assistant does.
 
@@ -28,16 +28,6 @@ There are two types of analysis you can perform on your code:
 
   Analyzes the external binary dependencies (such as NuGet packages) for your projects.
 
-<!--
-
-Cutting this out until the extension docs are written
-
-## Custom configuration
-
-You can use a configuration file for the code analysis engine to control how the analysis is performed.
-
--->
-
 ## Reports
 
 A dashboard report is generated after the analysis completes. This report breaks down the results by project, file, incident, and [story points](#incident-story-points). An aggregate view is also available, to group like-issues together regardless of what project they were detected in.

@@ -4,7 +4,7 @@ description: "Learn how to analyze one or more projects with .NET Upgrade Assist
 author: adegeo
 ms.author: adegeo
 ms.topic: how-to
-ms.date: 10/08/2024
+ms.date: 03/19/2026
 
 #customer intent: As a developer, I want to analyze my project before upgrading to identify any issues before performing an upgrade.
 
@@ -18,7 +18,7 @@ This article teaches you how to perform code analysis on your projects with .NET
 
 ## Prerequisites
 
-- For Visual Studio, see [Install .NET Upgrade Assistant - Visual Studio extension](upgrade-assistant-install.md#visual-studio-extension).
+- For Visual Studio, see [Enable .NET Upgrade Assistant - Visual Studio](upgrade-assistant-install.md#visual-studio).
 - For the .NET Global Tool, see [Install .NET Upgrade Assistant - .NET Global Tool](upgrade-assistant-install.md#net-global-tool).
 
 ## Create a report in Visual Studio

@@ -4,7 +4,7 @@ description: "Learn how to upgrade one or more projects with .NET Upgrade Assist
 author: adegeo
 ms.author: adegeo
 ms.topic: how-to
-ms.date: 10/08/2024
+ms.date: 03/19/2026
 
 #customer intent: As a developer, I want to upgrade my project to take advantage of the latest version of .NET.
 
@@ -20,7 +20,7 @@ Some project types have specific guidance on upgrading. For more information, se
 
 ## Prerequisites
 
-- For Visual Studio, see [Install .NET Upgrade Assistant - Visual Studio extension](upgrade-assistant-install.md#visual-studio-extension).
+- For Visual Studio, see [Enable .NET Upgrade Assistant - Visual Studio](upgrade-assistant-install.md#visual-studio).
 - For the .NET Global Tool, see [Install .NET Upgrade Assistant - .NET Global Tool](upgrade-assistant-install.md#net-global-tool).
 
 ## Upgrade a project in Visual Studio

@@ -1,58 +1,49 @@
 ---
 title: Install .NET Upgrade Assistant
-description: "Learn how to install .NET Upgrade Assistant as a Visual Studio extension or a .NET Global Tool. .NET Upgrade Assistant assists you when upgrading projects to the latest dependencies or when upgrading to a new .NET"
+description: "Learn how to install .NET Upgrade Assistant in Visual Studio or as a .NET Global Tool. .NET Upgrade Assistant assists you when upgrading projects to the latest dependencies or when upgrading to a new .NET"
 author: adegeo
 ms.author: adegeo
 ms.topic: install-set-up-deploy
-ms.date: 10/08/2024
+ms.date: 03/19/2026
 
 #customer intent: As a developer, I want to install .NET Upgrade Assistant so that I can upgrade my projects.
 
 ---
 
 # Install .NET Upgrade Assistant
 
-This article teaches you how to install .NET Upgrade Assistant using either the Visual Studio extension or the command-line interface (CLI) tool.
+This article teaches you how to install .NET Upgrade Assistant in Visual Studio or using the command-line interface (CLI) tool.
 
 [!INCLUDE [github-copilot-suggestion](includes/github-copilot-suggestion.md)]
 
 ## Prerequisites
 
 - Windows Operating System
-- [Visual Studio 2022 or later](https://visualstudio.microsoft.com/downloads/).
+- [Visual Studio 2026](https://visualstudio.microsoft.com/downloads/) (or Visual Studio 2022 version 17.14.17+).
 - [.NET SDK 8 or later](https://dotnet.microsoft.com/download/dotnet/).
 
 ## Methods
 
-.NET Upgrade Assistant can be installed as a Visual Studio extension or as a .NET Global Tool.
+.NET Upgrade Assistant is built into Visual Studio or can be installed as a .NET Global Tool.
 
-The Visual Studio extension runs inside Visual Studio, on the solution or project you have open. The .NET Global Tool is an interactive console application that runs on a solution or project file at or below the current directory.
+The Upgrade Assistant runs inside Visual Studio, on the solution or project you have open. The .NET Global Tool is an interactive console application that runs on a solution or project file at or below the current directory.
 
-If you want the streamlined experience of opening a project in Visual Studio and upgrading it, install the extension.
+If you want the streamlined experience of opening a project in Visual Studio and upgrading it, use the Upgrade Assistant.
 
-## Visual Studio Extension
+## Visual Studio
 
-The following steps install the Visual Studio extension.
-
-> [!TIP]
-> As an alternative to using the **Manage Extensions** feature of Visual Studio, you can download and run the extensions installer from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.upgradeassistant).
+The following steps enable the legacy Upgrade Assistant in Visual Studio.
 
 01. Open Visual Studio.
 
     If the **Open Recent \ Get Started** window opens, select the **Continue without code** link.
 
-01. Select the **Extensions** > **Manage Extensions** menu to open the **Extension Manager** window.
-01. Select the **Browse** tab.
-01. Type **.NET upgrade assistant** into the search box.
-01. Select the **.NET Upgrade Assistant** item, and then select **Install**.
-
-    :::image type="content" source="media/upgrade-assistant-install/visual-studio-manage-extensions.png" alt-text="The manage extensions window in Visual Studio, showing the .NET Upgrade Assistant.":::
-
-01. Once the extension finishes downloading, close Visual Studio to automatically start the installation.
+01. Select the **Tools** > **Options** menu, which opens the **Options** window.
+01. Navigate to **All Settings** > **Projects and Solutions** > **Modernization**.
+01. Select the **Enable legacy Upgrade Assistant** item.
+01. Restart Visual Studio
 
-    :::image type="content" source="media/upgrade-assistant-install/install-prompt.png" alt-text="A prompt to install the .NET Upgrade Assistant extension.":::
-
-01. Select **Modify** and follow the instructions to install the extension.
+    :::image type="content" source="media/upgrade-assistant-install/enable.png" alt-text="A screen shot showing the options window in Visual Studio with the Modernization settings page open.":::
 
 ## .NET Global Tool
 
@@ -76,11 +67,9 @@ The following steps install .NET Upgrade Assistant as a .NET Global Tool. .NET U
 
 The following information helps you determine that .NET Upgrade Assistant is installed.
 
-- **Visual Studio Extension**
-
-  There are two ways to determine if .NET Upgrade Assistant is installed as a Visual Studio extension. The quickest way is to right-click on any .NET or .NET Framework project in the **Solution Explorer** window and check for an **Upgrade** menu item.
+- **Visual Studio**
 
-  Another way is to select the **Extensions** > **Manage Extensions** menu to open the **Extension Manager** window. Then, select the **Installed** tab and find it in the list of installed extensions.
+  To determine if .NET Upgrade Assistant is enabled, right-click on any .NET or .NET Framework project in the **Solution Explorer** window and check for an **Upgrade** menu item.
 
 - **.NET Global Tool**
 

@@ -4,17 +4,17 @@ description: "Learn more about .NET Upgrade Assistant for .NET-related projects.
 author: adegeo
 ms.author: adegeo
 ms.topic: overview
-ms.date: 10/08/2024
+ms.date: 03/19/2026
 
 #customer intent: As a developer, I want to upgrade my project so that I can take advantage of the latest features.
 
 ---
 
 # What is .NET Upgrade Assistant?
 
-.NET Upgrade Assistant helps upgrade projects to newer versions of .NET and analyzes your code to spot and fix potential incompatibilities. One focus of the tool is to help upgrading a project from .NET Framework, .NET Core, or .NET, to the latest version of .NET. You use the extension or tool to upgrade entire .NET projects, or some aspect of the project, such upgrading a configuration file from an older type to a newer type.
+.NET Upgrade Assistant helps upgrade projects to newer versions of .NET and analyzes your code to spot and fix potential incompatibilities. One focus of the tool is to help upgrade a project from .NET Framework, .NET Core, or .NET, to the latest version of .NET. You use .NET Upgrade Assistant to upgrade entire .NET projects, or some aspect of the project, such as upgrading a configuration file from an older type to a newer type.
 
-.NET Upgrade Assistant is distributed as a Visual Studio extension or a command-line interface (CLI) tool.
+.NET Upgrade Assistant is built into Visual Studio and can be installed as a command-line interface (CLI) tool.
 
 [!INCLUDE [github-copilot-suggestion](includes/github-copilot-suggestion.md)]
 
@@ -42,7 +42,6 @@ Some products provide guidance on how to use .NET Upgrade Assistant.
 - [Windows Presentation Foundation](/dotnet/desktop/wpf/migration/)
 - [Windows Forms](/dotnet/desktop/winforms/migration/)
 - [Universal Windows Platform](/windows/apps/windows-app-sdk/migrate-to-windows-app-sdk/upgrade-assistant)
-- [Windows Communication Foundation](../../core/porting/upgrade-assistant-wcf.md)
 
 ## Upgrade paths
 

@@ -2,7 +2,7 @@
 title: Upgrade Assistant Telemetry
 description: Learn about telemetry collected by the Upgrade Assistant.
 author: tasou
-ms.date: 05/22/2023
+ms.date: 03/19/2026
 ---
 # Upgrade Assistant telemetry