Syncfusion AI Assistant

How can I help you?

Upgrade a Project to the latest Syncfusion® Version

18 Apr 20263 minutes to read

The Syncfusion® Blazor Migration add-in for Visual Studio helps you update an existing Syncfusion® Blazor project to a newer Essential Studio® release. The tool updates NuGet package references and theme links and provides an optional backup to preserve your project before applying changes.

Steps to migrate the project

  1. Open the existing Syncfusion® Blazor application in Visual Studio 2022 or Visual Studio 2026.

    Supported application types:

    • Blazor Web App (Server or WebAssembly rendering)
    • Blazor Server App
    • Blazor WebAssembly App (standalone or ASP.NET Core hosted)
    • Blazor WebAssembly App (Progressive Web Application)

  2. Open the Migration Wizard using one of the following options:

    • Choosing Extensions -> Syncfusion® -> Essential Studio® for Blazor -> Migrate Project… from the Visual Studio menu.

      Open the Migrate Project wizard from the Extensions menu in Visual Studio

    • Or right-clicking the project in Solution Explorer, selecting Syncfusion® Blazor, then choose Migrate Syncfusion® Blazor project from another version…

      Open the Migrate Project wizard from the Solution Explorer context menu

    NOTE

    The Migration option becomes available only after the project references the Syncfusion® Blazor NuGet packages.

  3. In the Syncfusion® Project Migration window, select the desired Syncfusion® Blazor version to migrate.

    Syncfusion Blazor Project Migration wizard with version selection

    NOTE

    Versions are loaded from the Syncfusion® Blazor NuGet packages available on NuGet.org and require an active internet connection.

  4. (Optional) Select Enable a backup before migrating to create a backup of the original project and choose a backup location.

  5. After migration completes, a confirmation message is displayed.

    Migration succeeded message after completing the project migration

    If a backup was created, the original project will be saved to the specified backup path.

    Backup location for the original project created during conversion

  6. The migration updates the Syncfusion® Blazor NuGet package references in the application’s .csproj to the selected version.

  7. If using trial setup or NuGet packages from nuGet.org, register the Syncfusion® license key in the application. Syncfusion® introduced license registration in the 2018 Volume 2 (v16.2.0.41) Essential Studio® release. See the licensing overview and key generation guide to generate and register Syncfusion® license key. For details about the licensing changes introduced in Essential Studio®, see the 2018 Volume 2 announcement.