Skip to content

Commit f0dd6e5

Browse files
committed
Use correct license key errors and codes
1 parent 51ce792 commit f0dd6e5

File tree

2 files changed

+38
-30
lines changed

2 files changed

+38
-30
lines changed

installation/license-key.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ The new license key includes information about all previous purchases. This proc
6363

6464
## Frequently Asked Questions
6565

66-
#### Does the license key expire?
66+
### Does the license key expire?
6767

6868
Yes, the license key expires at the end of your subscription:
6969

@@ -79,7 +79,7 @@ You need to download and install a new license key after:
7979

8080
An expired [perpetual license](https://www.telerik.com/purchase/faq/licensing-purchasing#licensing) key is valid for all Telerik UI for Blazor versions published before the license expiration date.
8181

82-
#### Will Telerik UI for Blazor function with an expired license key?
82+
### Will Telerik UI for Blazor function with an expired license key?
8383

8484
This depends on the [Telerik UI for Blazor license type (perpetual, subscription, or trial)](https://www.telerik.com/purchase/faq/licensing-purchasing#licensing):
8585

@@ -93,44 +93,44 @@ Scenarios that do not match the above three descriptions result in the following
9393
* A watermark appears on Telerik UI for Blazor components.
9494
* [A warning message appears in the application's build log](slug:troubleshooting-license-key-errors).
9595

96-
#### I updated the Telerik UI for Blazor version in my project and license errors appeared. Why?
96+
### I updated the Telerik UI for Blazor version in my project and license errors appeared. Why?
9797

9898
The most likely cause is that the new Telerik UI for Blazor version was released after the expiration date of your current license or license key. To fix this issue:
9999

100100
1. Renew your Telerik UI for Blazor license if necessary.
101101
1. [Update your license key](slug:installation-license-key)
102102

103-
#### Can I use the same license key in multiple builds?
103+
### Can I use the same license key in multiple builds?
104104

105105
You can use one license key in multiple pipelines, builds, and environments. However, each individual developer must use their own unique personal license key in their development environment.
106106

107-
#### Do I need an Internet connection to activate the license?
107+
### Do I need an Internet connection to activate the license?
108108

109109
No, the license validation and activation occur offline.
110110

111-
#### Do I have to add the license key to source control?
111+
### Do I have to add the license key to source control?
112112

113113
No, do not add the `telerik-license.txt` license key file or its contents to source control.
114114

115115
Do not store the license key in plain text in GitHub Actions Workflow definitions. Build servers [must use the `TELERIK_LICENSE` environment variable](slug:deployment-license-key).
116116

117-
#### What happens if both the environment variable and the license key file are present?
117+
### What happens if both the environment variable and the license key file are present?
118118

119119
If both the `TELERIK_LICENSE` environment variable and the `telerik-license.txt` file are present, then the environment variable will be used.
120120
To use the license key file, unset the environment variable.
121121

122-
#### What happens if several license key files exist?
122+
### What happens if several license key files exist?
123123

124124
If both a global and a project-specific `telerik-license.txt` files exist, then the project-specific license key will be used.
125125

126-
#### My team has more than one license holder. Which key do we have to use?
126+
### My team has more than one license holder. Which key do we have to use?
127127

128128
To activate Telerik UI for Blazor:
129129

130130
* [Every developer must be assigned their own license or seat](https://www.telerik.com/purchase/faq/licensing-purchasing).
131131
* Every developer must use a license key that is associated with their personal Telerik account.
132132

133-
#### Are earlier Telerik UI for Blazor versions affected?
133+
### Are earlier Telerik UI for Blazor versions affected?
134134

135135
No, versions up to **7.1.0** released prior to February 2025 do not require a license key.
136136

troubleshooting/license-key-errors.md

Lines changed: 28 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -25,44 +25,52 @@ A Telerik license key error may occur in the following scenarios:
2525
* Using an outdated license key after making renewals or purchases.
2626
* Using a license key that doesn't include Telerik UI for Blazor.
2727
* Using conflicting license keys in the same environment. For example, using one global license key and one in the app. Or, using a license key file together with an environment variable in CI/CD environment.
28+
* Corrupt license key
2829

29-
Refer to the error messages below for specific tips.
30+
Refer to the specific error messages and tips below.
3031

3132
## Error Messages
3233

33-
* [No license key is detected](#no-license-key-is-detected)
34-
* [Invalid license key](#invalid-license-key)
35-
* [Your subscription license has expired](#your-subscription-license-has-expired)
36-
* [Your perpetual license is invalid](#your-perpetual-license-is-invalid)
37-
* [Your trial license has expired](#your-trial-license-has-expired)
38-
* [Your license is not valid for the detected product(s)](#your-license-is-not-valid-for-the-detected-products)
34+
### No Telerik or Kendo UI product references detected in project (TKL001)
3935

40-
### No license key is detected
36+
This error can occur when a project references `Telerik.Licensing`, but not any other Telerik packages. If your scenario is different, please contact [Technical Support](https://www.telerik.com/account/support-center).
37+
38+
### No Telerik and Kendo UI License file found (TKL002)
4139

4240
[Install a license key file](slug:installation-license-key). If you already downloaded it, make sure it's [saved at the right place](slug:installation-license-key#manual-installation).
4341

44-
### Invalid license key
42+
### Corrupted Telerik and Kendo UI License Key content (TKL003)
43+
44+
Follow the [automatic](slug:installation-license-key#automatic-installation) or [manual](slug:installation-license-key#manual-installation) installation steps from scratch. Also check how to [set up a license key in CI/CD environments](slug:deployment-license-key).
45+
46+
If you have set a `TELERIK_LICENSE` environment variable through the Windows operating system's UI, then remove the environment variable and use a license key file instead.
47+
48+
### Unable to locate licenses for all products (TKL004)
49+
50+
Your license is not valid for the detected product(s).
51+
52+
[Review the purchase options for Telerik UI for Blazor](https://www.telerik.com/purchase/blazor-ui). If you have already purchased the required license, then, [update your license key](slug:installation-license-key#license-key-updates).
4553

46-
Follow the [automatic](slug:installation-license-key#automatic-installation) or [manual](slug:installation-license-key#manual-installation) installation steps from scratch.
54+
### Telerik UI for Blazor is not listed in your current license file (TKL101)
4755

48-
### Your subscription license has expired
56+
Your license is not valid for the detected product(s).
4957

50-
<a href="https://www.telerik.com/account/your-licenses" target="_blank">Renew your subscribtion</a>. Then, [update your license key](slug:installation-license-key#license-key-updates).
58+
[Review the purchase options for Telerik UI for Blazor](https://www.telerik.com/purchase/blazor-ui). If you have already purchased the required license, then, [update your license key](slug:installation-license-key#license-key-updates).
5159

52-
### Your perpetual license is invalid
60+
### Your current license has expired (TKL102)
5361

54-
You are using a product version released outside the validity period of your perpetual license. To remove the error message, do either of the following:
62+
This error applies to perpetual licenses. It means that you are using a product version released outside the validity period of your license. To remove the error message, do either of the following:
5563

56-
* <a href="https://www.telerik.com/account/your-licenses" target="_blank">Renew your subscribtion</a>. Then, [update your license key](slug:installation-license-key#license-key-updates).
57-
* Downgrade your app to a Telerik UI for Blazor version that was released within the subscription period of your perpetual license.
64+
* [Renew your license](https://www.telerik.com/account/your-licenses) and then, [update your license key](slug:installation-license-key#license-key-updates).
65+
* Use a Telerik UI for Blazor version that was released within the subscription period of your perpetual license.
5866

59-
### Your trial license has expired
67+
### Your subscription has expired (TKL103, TKL104)
6068

61-
<a href="https://www.telerik.com/purchase/blazor-ui" target="_blank">Purchase a commercial license to continue using Telerik UI for Blazor</a>.
69+
This error applies to subscription licenses. [Renew your subscription](https://www.telerik.com/account/your-licenses) and then, [update your license key](slug:installation-license-key#license-key-updates).
6270

63-
### Your license is not valid for the detected product(s)
71+
### Your trial expired (TKL105)
6472

65-
<a href="https://www.telerik.com/purchase/blazor-ui" target="_blank">Review the purchase options for Telerik UI for Blazor</a>. Then, [update your license key](slug:installation-license-key#license-key-updates).
73+
[Purchase a commercial license to continue using Telerik UI for Blazor](https://www.telerik.com/purchase/blazor-ui).
6674

6775
## See Also
6876

0 commit comments

Comments
 (0)