Convert a Blazor Application to Syncfusion® Blazor

16 Jul 20263 minutes to read

This guide explains how to convert an existing Blazor application into a Syncfusion® Blazor application using the Syncfusion® Project Conversion wizard for Visual Studio 2022 or 2026. The conversion installs the required Syncfusion® NuGet packages, registers component namespaces, and applies the selected theme stylesheet.

Prerequisites

  • Visual Studio 2022 or 2026 with the Syncfusion® Blazor Template Studio extension installed. See download and installation if it is not installed.
  • .NET 8.0, .NET 9.0, or .NET 10.0 SDK matching the target Syncfusion® Blazor version.
  • An active internet connection to load the available Syncfusion® Blazor versions from NuGet.org.
  • If you are behind a proxy or firewall, ensure that nuget.org is reachable.

Supported project 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)

Steps

  1. Open your Blazor project in Visual Studio 2022 or 2026.

  2. Launch the Syncfusion® Project Conversion wizard by either:

    • Choosing Extensions → Syncfusion® → Essential Studio® for Blazor → Convert Project…

      Open Convert Project from the Extensions menu in Visual Studio

    • Or right-clicking the project in Solution Explorer, selecting Syncfusion® Blazor, then Convert to Syncfusion® Blazor application…

      Open Convert Project from the Solution Explorer context menu

  3. In the Project Conversion window, select the target Syncfusion® Blazor version and the theme to apply. The default theme is Bootstrap 5. Available themes include Material, Fabric, Bootstrap, Bootstrap 4, Tailwind, Fluent, and Material 3.

    Syncfusion Blazor Project Conversion wizard with version and theme selection

    NOTE

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

  4. (Optional) Select Enable a backup before converting and use the Browse button to choose a backup location. A copy of the original project is saved to the selected path before the conversion is applied.

  5. Review your selections and click Convert.

  6. After conversion finishes, you will see a confirmation message.

    Conversion succeeded message after completing the conversion

    If a backup was created, the original project is saved to the selected backup path.

    Backup location for the original project created during conversion

  7. Close and reopen Visual Studio to ensure the theme stylesheet and namespace registrations are applied. The conversion updates the following:

    • The Syncfusion.Blazor NuGet package reference in the .csproj file.
    • The Syncfusion.Blazor.Themes package reference for the selected theme.
    • The theme stylesheet link in wwwroot/index.html (WebAssembly) or Pages/_Host.cshtml / App.razor (Server / Web App).
    • Component namespaces in _Imports.razor.

  8. If you installed packages from nuget.org or the trial setup, register your Syncfusion® license key. Licensing was introduced in the 2018 Volume 2 (v16.2.0.41) release. See the licensing overview and key generation guide for details. For background, see the 2018 Volume 2 announcement.