Skip to content

Commit 6c77126

Browse files
committed
Emphasize auto license key download
1 parent 5cb4e2b commit 6c77126

File tree

2 files changed

+46
-20
lines changed

2 files changed

+46
-20
lines changed
Loading

getting-started/licensing/installing-license-key.md

Lines changed: 46 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -8,31 +8,56 @@ published: True
88
position: 0
99
---
1010

11-
# Installing License Key
11+
# Installing Your License Key
1212

13-
Starting with the 2025 Q1 release, the UI components from the WPF library require activation through a license key (trial or commercial). This article describes how to download your personal license key and use it to activate the WPF UI components.
13+
Starting with the 2025 Q1 release, the UI components from the WPF library require activation through a license key (trial or commercial). This article describes how to download your personal license key and use it to activate the WPF UI components. An invalid license results in [errors and warnings]({%slug license-activation-errors-and-warnings%}) during build and run-time indicators such as watermarks and banners.
1414

15-
An invalid license results in [errors and warnings]({%slug license-activation-errors-and-warnings%}) during build and run-time indicators such as watermarks and banners.
15+
To download a license key for Telerik UI for WPF, you must have either a developer or trial license. If you are new to Telerik UI for WPF, sign up for a [free trial](https://www.telerik.com/try/ui-for-wpf) first, and then follow the steps below.
1616

17-
## Downloading the License Key
17+
Depending on your development environment and preferences, you can install your license key in either of the following ways:
1818

19-
To download a license key for Telerik UI for WPF, you must have either a developer or trial license. If you are new to Telerik UI for WPF, sign up for a [free trial](https://www.telerik.com/try/ui-for-wpf) first, and then follow the steps below.
19+
* [*Automatic installation*](#automatic-license-key-installation) for NuGet-based development—suitable for developers using Telerik productivity tools like the Telerik extensions for Visual Studio and the Progress Control Panel.
20+
* [*Manual installation*](#manual-license-key-installation) for NuGet-based development—suitable for trial users and developers who prefer to manage their projects and Telerik product versions manually.
21+
* [*Manual installation for projects without NuGet references*](#adding-a-license-key-to-projects-without-nuget-references)—suitable for developers who cannot use NuGet references in their projects.
2022

21-
1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account.
23+
## Automatic License Key Installation
2224

23-
1. Click the __Download License Key__ button.
24-
25-
![Picture showing the License Keys page](images/installing-license-key-0.png)
25+
Telerik provides tools that automatically provision your license key. These tools include the [Telerik UI for WPF Visual Studio extensions]({%slug radcontrols-for-wpf-vs-extensions-overview-wpf%}) and the [Progress Control Panel](https://docs.telerik.com/controlpanel/introduction).
26+
27+
### Installing a License Key with the VS Extensions
28+
29+
To install your license key by using the [Telerik UI for WPF Visual Studio extensions]({%slug radcontrols-for-wpf-vs-extensions-overview-wpf%}):
30+
31+
1. Open Visual Studio.
32+
1. Go to **Extensions** > **Telerik** > **Licensing** > **Download Key**.
33+
34+
![Picture showing the License Keys page](images/vsx-download-license-key-file.png)
35+
36+
The Visual Studio extension puts the file in your home directory (`%appdata%\Telerik`), which activates the WPF components.
2637

27-
> The [Progress Control Panel](https://www.telerik.com/download-trial-file/v2/control-panel) and the [Visual Studio Extensions]({%slug radcontrols-for-wpf-vs-extensions-overview-wpf%}) will automatically download and store your license key in the `%appdata%\Telerik` directory. This makes it available for all projects developed on the local machine.
38+
### Installing a License Key with the Progress Control Panel
2839

29-
## Activating the UI for WPF Components
40+
Upon starting the [Progress Control Panel](https://docs.telerik.com/controlpanel/introduction), the application automatically downloads your license key file to your home directory (`%appdata%\Telerik`), which activates the WPF components.
3041

31-
To activate the UI for WPF components:
42+
To manually trigger the license key download—for example, when you renew you license or purchase a new one:
3243

33-
* Copy the [downloaded](#downloading-the-license-key) `telerik-license.txt` license key file to your home directory (`%appdata%\Telerik`). This makes it available for all projects developed on the local machine.
44+
1. Open the Progress Control Panel.
45+
1. Go to **View all subscriptions**.
46+
1. Click **DOWNLOAD LICENSE KEY**.
3447

35-
* Alternatively, copy the `telerik-license.txt` license key file to the root folder of your project. This makes the license key available only to this project. Do not commit the file to source control as this is your personal license key.
48+
## Manual License Key Installation
49+
50+
To manually download and install a license key for Telerik UI for WPF:
51+
52+
1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account.
53+
54+
1. Click the __Download License Key__ button.
55+
56+
![Picture showing the License Keys page](images/installing-license-key-0.png)
57+
58+
1. Copy the downloaded `telerik-license.txt` license key file to your home directory (`%appdata%\Telerik`). This makes it available for all projects developed on the local machine.
59+
60+
Alternatively, copy the `telerik-license.txt` license key file to the root folder of your project. This makes the license key available only to this project. Do not commit the file to source control as this is your personal license key.
3661

3762
When you build the project, the `Telerik.Licensing` NuGet package automatically locates the license file and uses it to activate the product. If your project doesn’t use NuGet packages, see [Adding a License Key to Projects without NuGet References](#adding-a-license-key-to-projects-without-nuget-references).
3863

@@ -44,19 +69,20 @@ If you cannot use NuGet packages in your project, add the license as a code snip
4469

4570
1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account.
4671

47-
1. On the Progress® Telerik® UI for WPF row, click the __View key__ link in the __SCRIPT KEY__ column.
72+
1. On the Progress® Telerik® UI for WPF row, click the __View key__ link in the __SCRIPT KEY__ column.
4873

49-
1. Copy the C# code snippet into a new file, for example, `TelerikLicense.cs`.
74+
1. Copy the C# code snippet into a new file, for example, `TelerikLicense.cs`.
5075

51-
1. Add the `TelerikLicense.cs` file to your project.
76+
1. Add the `TelerikLicense.cs` file to your project.
5277

53-
Do not publish the license key code snippet in publicly accessible repositories. This is your personal license key.
78+
>Do not publish the license key code snippet in publicly accessible repositories. This is your personal license key.
5479
5580
## Updating Your License Key
5681

57-
Whenever you purchase a new Telerik UI for WPF license or renew an existing one, always [download a new license key](#downloading-the-license-key). The new license key includes information about all previous license purchases. This process is referred to as a license key update. Once you have the new license key, use it to [activate the components](#activating-the-ui-for-wpf-components).
82+
Whenever you purchase a new Telerik UI for WPF license or renew an existing one, always download and install a new license key by using the [automatic](#automatic-license-key-installation) or the [manual](#manual-license-key-installation) approach. The new license key includes information about all previous license purchases. This process is referred to as a license key update.
83+
84+
## See Also
5885

59-
## See Also
6086
* [License Activation Errors and Warnings]({%slug license-activation-errors-and-warnings%})
6187
* [Adding the License Key to CI Services]({%slug installing-license-to-ci-services%})
6288
* [Frequently Asked Questions about Your UI for WPF License Key]({%slug license-frequently-asked-questions%})

0 commit comments

Comments
 (0)