Introduction
Accessibility
Knowledge Base
API Reference
Knowledge Base / Diagnostic Options for Telerik Licensing
New to Telerik Document Processing? Start a free 30-day trial

Diagnostic Options for Telerik Licensing

Updated on Nov 10, 2026

Environment

VersionProductAuthor
2025.1.205Telerik Document ProcessingDesislava Yordanova

Description

This article describes follow-up steps you can take if the trial message persists, even after following the steps listed in the Setting Up Your Telerik Document Processing Libraries License Key article.

This knowledge base article also answers the following questions:

  • How to properly set up Telerik Document Processing license keys?
  • How to resolve trial version messages?
  • How to verify included assemblies for Telerik Document Processing?

Solution

Ensure your license includes the respective product. Without a valid license for the respective Telerik product, the trial version message persists. Verify your license details on the Telerik Purchase page.

Telerik Document Processing is distributed with several bundles. Learn What Versions of Document Processing Libraries are Distributed with the Telerik Products. To integrate and validate its license, follow these steps:

  • Remove any environment variables such as KENDO_UI_LICENSE or TELERIK_LICENSE , as they may cause licensing issues due to length limitations on Windows. Instead, use the telerik-license.txt file as described in Setting Up Your Telerik Document Processing Libraries License Key.

  • Use the TelerikLicensingVerbosity configuration in your project file to enable detailed licensing diagnostics during build. The following example shows a sample configuration of the project file:

xml
   <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
       <OutputType>Exe</OutputType>
       <TargetFramework>net9.0</TargetFramework>
       <RootNamespace>MyProjNamespace</RootNamespace>
       <ImplicitUsings>enable</ImplicitUsings>
       <Nullable>enable</Nullable>
       <TelerikLicensingVerbosity>diagnostic</TelerikLicensingVerbosity>
     </PropertyGroup>
     <ItemGroup>
       <PackageReference Include="Telerik.Documents.Spreadsheet" Version="2025.2.520" />
       <PackageReference Include="Telerik.UI.for.AspNet.Core" Version="2025.1.227" />
     </ItemGroup>
   </Project>
  • Build the project and verify the Output window for confirmation that the license setup is valid.

Verbosity Values

TelerikLicensingVerbosity controls how much information the Telerik licensing targets emit during the build process. The available values are:

ModeAccepted valuesDescription
Quietq, Q, quiet, QuietReduces routine licensing output; high-priority messages remain visible.
Verbosev, V, verbose, VerboseShows more licensing details by increasing message importance.
Diagnosticd, D, diag, Diag, diagnostic, Diagnostic, diagnostics, DiagnosticsPromotes all licensing messages to high importance for troubleshooting.
Normal (default)Unset or any unrecognized valueUses standard licensing output.

For maximum logging during troubleshooting:

xml
<PropertyGroup>
  <TelerikLicensingVerbosity>diagnostic</TelerikLicensingVerbosity>
</PropertyGroup>

The following sample build output shows license lookup and resolution messages during a successful rebuild. Account details, organization names, and license identifiers use placeholders:

text
     Provision Licensing
           Looking up license file...
           - EnvironmentVariablePath: TELERIK_LICENSE_PATH (NotAvailable)
           - EnvironmentVariable: TELERIK_LICENSE (NotAvailable)
           - EnvironmentVariable: KENDO_UI_LICENSE (NotAvailable)
           - RecursiveFilePath: C:\Users\MyUserName\MyProjects\WinForms_Sample\telerik-license.txt (NotAvailable)
           - RecursiveFilePath: C:\Users\MyUserName\MyProjects\WinForms_Sample\kendo-ui-license.txt (NotAvailable)
           - RecursiveFilePath: C:\Users\MyUserName\OneDrive - Contoso\MyProjects\telerik-license.txt (NotAvailable)
           - RecursiveFilePath: C:\Users\MyUserName\OneDrive - Contoso\MyProjects\kendo-ui-license.txt (NotAvailable)
           - RecursiveFilePath: C:\Users\MyUserName\OneDrive - Contoso\telerik-license.txt (NotAvailable)
           - RecursiveFilePath: C:\Users\MyUserName\OneDrive - Contoso\kendo-ui-license.txt (NotAvailable)
           - RecursiveFilePath: C:\Users\MyUserName\telerik-license.txt (NotAvailable)
           - RecursiveFilePath: C:\Users\MyUserName\kendo-ui-license.txt (NotAvailable)
           - RecursiveFilePath: C:\Users\telerik-license.txt (NotAvailable)
           - RecursiveFilePath: C:\Users\kendo-ui-license.txt (NotAvailable)
           - RecursiveFilePath: C:\telerik-license.txt (NotAvailable)
           - RecursiveFilePath: C:\kendo-ui-license.txt (NotAvailable)
           - UserDirectory: C:\Users\MyUserName\AppData\Roaming\Telerik\telerik-license.txt (LicenseFound)
           - UserDirectory: C:\Users\MyUserName\AppData\Roaming\Telerik\kendo-ui-license.txt (Skip)
           LicenseKey
           - AUD: u***@example.com
           - UsedId: YourUserID
           - LicenseId: YourLicenseID
           - IssuedAt: 10/6/2026 8:52:46 AM
           - Licenses
             0) Subscription BLAZOR, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             1) Trial FORGE, expiration 11/6/2026 9:52:44 AM, type: 'trial'
             2) Subscription JM, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             3) Subscription KENDOUIANGULAR, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             4) Subscription KENDOUICOMPLETE, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             5) Subscription KENDOUIMVC, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             6) Subscription KENDOUIREACT, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             7) Subscription KENDOUIVUE, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             8) Subscription MAUI, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             9) Subscription RCAJAX, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             10) Subscription RCWF, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             11) Subscription RCWPF, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             12) Subscription REPORTING, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             13) Subscription REPORTSERVER, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             14) Subscription UIASPCORE, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             15) Subscription UIXAM, expiration 2/19/2025 6:00:00 AM, type: 'subscription'
             16) Subscription WINUI, expiration 8/18/2027 5:00:00 AM, type: 'subscription'
             17) Usage UserId: YourUserId, LicenseId: YourLicenseID, type: 'usage'
     License Resolution
           Messages
             - License OK for "Telerik UI for WinForms" (RCWF) 2026.3.1007.90 @2026-10-07 - Subscription, valid until 2027-08-18.
             - License OK for "Telerik Document Processing Libraries" (DPL) 2026.3.1006.100 @2026-10-06 - Subscription for RCWF, valid until 2027-08-18.
           JWTs
             - YourLicenseKey
           Licenses
             - License OK for "Telerik UI for WinForms" (RCWF) 2026.3.1007.90 @2026-10-07 - Subscription, valid until 2027-08-18.
             - License OK for "Telerik Document Processing Libraries" (DPL) 2026.3.1006.100 @2026-10-06 - Subscription for RCWF, valid until 2027-08-18.
   OutputType: WinExe, ImportXamlTargets: True
   LicenseEvidence CodeGen: obj\Debug\net10.0-windows\Telerik.Licensing.LicenseInfo.cs

         Call-Home Telerik Products (2 for net10.0-windows)
         - "Telerik UI for WinForms" (RCWF) 2026.3.1007
         - "DPL" (DPL) 2026.3.1006


         Call-Home Telerik Features (0 for net10.0-windows)

     Instantiate Licensing Client...
     Resolve Licensing Context...
     Send Events...
     Report Telerik.Licensing
           UserId: YourUserId
           LicenseId: YourLicenseId
           Products
           - LicenseUsed RCWF 2026.3.1007.90 SKIPPED
           - LicenseUsed DPL 2026.3.1006.100 SKIPPED
         Report finished in 00:00:00.0675129
     Licensing Metrics done 00:00:00.0675129
     Sending Telemetry...
     Instantiate Call-Home Client...
     Resolve Call-Home Context...
     Send Events...
     Metrics done 00:00:00.0505100
   [Telerik and Kendo UI Licensing]
         Telerik and Kendo UI License Key found at: C:\Users\MyUserName\AppData\Roaming\Telerik\telerik-license.txt (UserDirectory)
         License issued at 2026-10-06 to u***@example.com.
   [Telerik and Kendo UI Licensing]
         Your Telerik UI for WinForms subscription is active. Expiration in 281 days.
   [Telerik and Kendo UI Licensing]
         Your Telerik Document Processing Libraries subscription is active. Expiration in 281 days.
   Resolve Telerik Products. Done (00:00:00.3798748) for net10.0-windows
========== Rebuild All: 1 succeeded, 0 failed, 0 skipped ==========
========== Rebuild completed at 12:28 PM and took 22.470 seconds ==========

The following sections explain the sample build output above. License locations, entitlements, expiration dates, and resolution results can differ in your environment.

License Discovery

During the Provision Licensing phase, the build searches for a Telerik license key in supported locations, including environment variables, project folders, parent directories, and the Telerik user profile directory. After checking multiple locations, a valid license file is found at: C:\Users\MyUserName\AppData\Roaming\Telerik\telerik-license.txt. This confirms that licensing is configured through the standard Telerik user-profile location rather than through environment variables or a repository-local license file.

License Information

The discovered license contains several Telerik and Kendo UI product entitlements associated with the licensed user account. Most subscriptions are active through 18-Aug-2027, including Telerik UI for WinForms (RCWF) and related product suites. The presence of multiple product entitlements indicates a bundled subscription such as DevCraft or a similar Telerik subscription package.

License Resolution

The License Resolution phase validates that the license covers the specific Telerik assemblies referenced by the project. The build confirms valid licensing for:

  • Telerik UI for WinForms (RCWF) version 2026.3.1007.90
  • Telerik Document Processing Libraries (DPL) version 2026.3.1006.100

Both products are covered by an active subscription valid until 18-Aug-2027, allowing the build to proceed without trial limitations or licensing warnings.

For runtime investigations, see the separate runtime licensing diagnostics workflow.

See Also

In this article
EnvironmentDescriptionSolutionVerbosity ValuesLicense DiscoveryLicense InformationLicense ResolutionSee Also
Not finding the help you need?
Contact Support