For cross-platform mobile apps, register the key in the App constructor to ensure it applies to all target platforms (iOS, Android, Windows).
Never hardcode it in source control.
import registerLicense from '@syncfusion/ej2-base'; // Register Syncfusion license registerLicense('YOUR_ACTUAL_LICENSE_KEY_HERE'); Use code with caution. For .NET MAUI / Xamarin ( App.xaml.cs ) Add the registration inside the App constructor:
You must register the license key before rendering any Syncfusion components. This is typically done in the global entry point of your application. For Blazor / ASP.NET Core ( Program.cs ) Place the registration code before builder.Build(); : syncfusion trial license key fix
| Issue | Fix | |-------|-----| | “License key is invalid” | Re-copy key from account (no extra spaces). Ensure no line breaks. | | Still showing trial popup | Place registration any Syncfusion control is created/loaded. | | Expired immediately | Trial keys last 30 days . Generate a new trial key. | | NuGet package mismatch | Use latest NuGet packages matching your trial key version. | | Multiple projects | Register key once in startup project (for .NET). |
: If your trial period has expired and you're unable to resolve license issues, consider purchasing a license. This will provide you with a valid license key and access to official support.
folders and rebuild the application to clear cached trial assemblies that may still be triggering warnings. NuGet Cache Clearing For cross-platform mobile apps, register the key in
Add this code (e.g., in Program.cs , App.xaml.cs , or Main method):
Blazor WASM runs in the browser. The RegisterLicense must be called in Program.cs of the client project, the server project. Also, ensure the key is not exposed to the client if security is a concern (use a backend API to validate the license).
A: No. The trial key is for evaluation only. Using it in production is a violation of the EULA, and it will stop working after 30 days. Ensure no line breaks
If your trial has expired, you may be eligible for the if your company has less than $1 million USD in annual gross revenue and fewer than 5 developers. This removes the trial warning entirely. Troubleshooting Common Errors Probable Cause "Trial Expired" banner appears Trial period (30 days) has ended. Generate a new key or register for the Community License. Warning persists after key added License key registered after component render. Move registerLicense to the very top of your entry file. License key invalid error Key does not match package version or platform.
If it still fails, use Syncfusion’s :
Follow these steps to clear the watermark and fix licensing errors in your application. Step 1: Generate the Correct License Key Log in to your . Navigate to the License & Downloads section. Click on Downloads & Keys .
In App.xaml.cs (WPF) or Program.cs (WinForms), inside the constructor or OnStartup :