Syncfusion Blazor License Configuration

Manage Syncfusion Blazor license keys across all Blazor project types - Server, WebAssembly, Auto, and Razor Class Libraries.

When to Use

Use this skill when you need to:

• Generate a Syncfusion license key (paid, trial, or temporary)
• Register a license key in any Blazor project type
• Secure license keys in Blazor WebAssembly projects (avoid browser exposure)
• Validate licenses in CI/CD pipelines (Azure Pipelines, GitHub Actions, Jenkins)
• Troubleshoot license errors — trial banner, invalid key, platform or version mismatch

Do NOT use for:

• Initial Blazor project setup → use syncfusion-blazor-common

Key Rules

• Version Specific: License keys are version-specific for the Syncfusion platform
• Platform Specific: Different keys for different platforms (Blazor, ASP.NET, etc.)
• WASM Security: Never register license keys in client-side Blazor WebAssembly Program.cs — use licensed NuGet packages instead
• Confidentiality: License keys are secrets. Never share or commit them to source

Common Scenarios

Generate a license key

• [Reference: Generating License Keys](./references/license-registration#generating-license-keys)

Register a license key

• [Reference: Registering License Keys](./references/license-registration#registering-license-keys-in-applications)

Razor Class Library with Syncfusion Blazor components

• [Reference: Registering in RCLs](./references/license-registration#registering-when-consuming-a-razor-class-library-rcl)

Blazor WebAssembly app (security concern)

Security Warning (WASM): Do NOT register license keys in client-side Blazor WebAssembly Program.cs or commit keys into source. Client-side assemblies are downloadable and can expose license keys to end users. Treat license keys like secrets.

⚠️ Do NOT register keys in client-side code. See secure deployment options:

• [Reference: Secure Registration in WASM Apps](./references/license-registration#secure-registration-in-blazor-wasm-apps)

Recommended: Use licensed NuGet packages instead

• [Reference: Web Installer - How to Download](./references/syncfusion-blazor-web-installer-download)
• [Reference: Web Installer - How to Install](./references/syncfusion-blazor-web-installer-install)

Troubleshooting license errors

• [Reference: Troubleshooting Licensing Errors](./references/license-registration#troubleshooting-licensing-errors)

FAQ

• [Licensing FAQ](./references/license-registration#licensing-faq)