Register Syncfusion® License key in Blazor Application

2 Jul 20253 minutes to read

Syncfusion® license key should be registered, if your project using Syncfusion® Blazor packages reference from nuget.org or from trial installer. The generated license key is just a string that needs to be registered before any Syncfusion® control is initiated. The following code is used to register the license.

Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR LICENSE KEY");

NOTE

  • Place the license key between double quotes. Also, ensure that Syncfusion.Licensing.dll is referenced in your project where the license key is being registered.
  • Syncfusion® license validation is done offline during application execution and does not require internet access. Apps registered with a Syncfusion® license key can be deployed on any system that does not have an internet connection.

IMPORTANT

Syncfusion® license keys can be validated during the Continuous Integration (CI) processes to ensure proper licensing and prevent licensing errors during deployment. Refer to the CI License Validation section for detailed instructions on how to implement it.

Blazor Mode Project(s) to Register License Key File(s) to Register License Key
Blazor Web App (Interactive Auto) Server & Client Server/Program.cs, Client/Program.cs
Blazor Web App (Interactive Server) Server Server/Program.cs
Blazor Web App (Interactive WASM) Server & Client Server/Program.cs, Client/Program.cs
Blazor Standalone WebAssembly App Client Program.cs

Blazor Web App (Interactive Auto)

Open ~/Program.cs file in both the server and client projects of a Blazor Web App(Interactive Auto) and register the Syncfusion® Blazor license key.

//Register Syncfusion license
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR LICENSE KEY");

Blazor Web App (Interactive Server)

  • For .NET 8 and .NET 9, open the ~/Program.cs file and register the Syncfusion® license key.
var app = builder.Build();
//Register Syncfusion license
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR LICENSE KEY");

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

Blazor Web App (Interactive WebAssembly)

Open ~/Program.cs file in both the server and client projects of a Blazor Web App(Interactive WebAssembly) and register the Syncfusion® Blazor license key.

//Register Syncfusion license
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR LICENSE KEY");

Blazor Standalone WebAssembly App

Open ~/Program.cs file and register the Syncfusion® Blazor license key in the client web app.

//Register Syncfusion license
Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense("YOUR LICENSE KEY");

var builder = WebAssemblyHostBuilder.CreateDefault(args);

....
....