Troubleshooting the "Trial Version of Syncfusion Essential Studio" License Validation Message in Embedded Bold BI Dashboards
When embedding Bold BI dashboards in an application using the Bold BI Embedded SDK, a license validation banner may appear at the top of the dashboard with the following message:
This application was built using a trial version of Syncfusion® Essential Studio®. To remove the license validation message permanently, a valid license key must be included.
This article explains the common causes of this issue and provides the recommended troubleshooting steps.
Possible Causes
1. SDK and Bold BI Server Version Mismatch
A mismatch between the Bold BI Server version and the Bold BI Embedded SDK version can trigger license validation issues, particularly when using multi-tab dashboard embedding.
Behavior
- For single-dashboard embedding, license validation is performed at the Bold BI Server level.
- For multi-tab dashboard embedding, license validation is performed at the Embedded SDK component level.
- When the SDK version does not match the corresponding Bold BI Server version, license validation errors or unexpected behavior may occur.
Resolution
Ensure that the Embedded SDK version matches the corresponding Bold BI Server version being used.
Refer to the following compatibility matrix to verify that the appropriate SDK wrapper version is being used with the installed Bold BI version.
| Bold BI Version | SDK Wrapper Version |
|---|---|
| v11.1.5 | v10.1.18 |
| v14.1.20 | v14.1.11 |
| v14.2.4 | v14.2.4 |
| v15.1.65 | v15.1.65 |
| v15.2.6 | v15.2.6 |
| v15.3.8 | v15.2.6 |
| v16.1.70 | v16.1.70 |
| v16.2.5 | v16.2.5 |
| v16.3.5 | v16.3.5 |
Note: The table above is provided as a reference. For other Bold BI releases, refer to the Important Notes section of the corresponding release history page to identify the compatible SDK wrapper version. For more information, refer the Release History page here.
2. Usage of Custom Widgets in Dashboards
The issue can also occur when dashboards contain custom widgets that internally reference Syncfusion components that require a valid license.
If the license validation message continues to appear even after using a compatible Embedded SDK version, and the affected dashboard contains custom widgets, create a support ticket with the Bold BI Support team and include the corresponding custom widget (.bicw) file. This will help the team analyze the widget implementation, identify the root cause, and provide an appropriate solution more quickly.
Create a support ticket:
https://www.boldbi.com/support/
