Added new kb article license-not-recognized-telerik-document-processing-libraries

distribution-and-licensing/license-key/setting-up-license-key.md

@@ -70,4 +70,5 @@ Whenever you purchase a new license or renew an existing one, always [download a
 * [Handling License Key File Name and Environment Variable Name Changes in the 2025 Q1 Release]({%slug handling-license-file-name-changes%})
 * [Telerik.Licensing NuGet package is not available on the Telerik NuGet feed]({%slug dpl-telerik-licensing-nuget-feed%})
 * [Diagnostic Options for Telerik Licensing]({%slug telerik-trial-version-message-diagnostic-options%})
+* [Resolving License Validation Issues in Telerik Document Processing Libraries]({%slug license-not-recognized-telerik-document-processing-libraries%})
 

knowledge-base/license-not-recognized-telerik-document-processing-libraries.md

@@ -0,0 +1,56 @@
+---
+title: Resolving License Validation Issues in Telerik Document Processing Libraries
+description: Troubleshooting the issue where the license is not recognized during runtime in Telerik Document Processing Libraries.
+type: troubleshooting
+page_title: License Not Recognized in Telerik Document Processing Libraries
+meta_title: License Not Recognized in Telerik Document Processing Libraries
+slug: license-not-recognized-telerik-document-processing-libraries
+tags: telerik, document, processing, license, validation, runtime, issues, licensing diagnostics
+res_type: kb
+ticketid: 1690929
+---
+
+## Environment
+
+| Version | Product | Author | 
+| ---- | ---- | ---- | 
+| 2025.2.520| RadPdfProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+
+This article aims to address potential licensing issues while generating Excel (or PDF, DOCX, etc.) files with Telerik Document Processing Libraries during **runtime** testing. The generated file contains a "License" sheet (or a watermark) with a trial message, despite the **Build Output** window indicating a valid license. The issue arises in a multi-project (e.g. Blazor WASM) application setup, where dependencies are shared across projects.
+
+## Cause
+
+This issue generally occurs due to incomplete license validation during runtime in complex setups, particularly when using shared libraries or plugin architectures. *Even if the license is validated during build time, runtime environments may fail to recognize it due to transitive dependency limitations.*
+
+## Solution
+
+To ensure proper license validation and eliminate trial messages, follow the steps below:
+
+1. **License Key Placement**: Ensure the `telerik-license.txt` file is present in the root directory of all projects referencing Telerik Document Processing Libraries, including shared libraries or class libraries.
+
+2. **Explicit License Registration**: Add a call to `TelerikLicensing.Register()` early in your application lifecycle. For Blazor WASM applications, include this call in the `Program.cs` file. This approach validates the license explicitly.
+
+3. **Verify Assemblies**: Ensure **no trial** versions of Telerik assemblies are referenced in any project. Replace [trial assemblies]({%slug upgrade-trial-to-licensed-version%}) with licensed ones, if such even exist.
+
+4. **Enable Diagnostics**: Add the following property to your `.csproj` file to enable detailed licensing diagnostics during build and runtime:
+   ```xml
+   <PropertyGroup>
+       <TelerikLicensingVerbosity>diagnostic</TelerikLicensingVerbosity>
+   </PropertyGroup>
+   ```
+   Review the diagnostic output for clues about license validation issues.
+
+5. **Direct Package References**: Add references to the Telerik Document Processing Libraries NuGet packages directly in the Blazor WASM project. This resolves transitive dependency limitations.
+
+6. **Avoid Environment Variables**: Use only the `telerik-license.txt` file for license delivery instead of environment variables, which can cause issues due to length limitations.
+
+By following these steps, runtime validation issues should resolve, and the trial message will no longer appear in generated documents.
+
+## See Also
+
+- [Telerik Document Processing Licensing Overview]({%slug introduction%})
+- [Setting Up Your Telerik Document Processing Libraries License Key]({%slug setting-up-license-key%})
+- [Using TelerikLicensing.Register Method]({%slug adding-license-key-ci-cd-services%}#using-teleriklicensingregister-method-on-aws-lambdas)
+- [Diagnostic Options for Telerik Licensing]({%slug telerik-trial-version-message-diagnostic-options%})