# First Steps with Telerik UI for WinForms

This tutorial shows how to create your first Telerik UI for WinForms desktop application.

## Prerequisites

* To download Telerik UI for WinForms packages, you need a [Telerik account](https://www.telerik.com/account/). If you do not have, you can [create one for free](https://www.telerik.com/account/).
* Install [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) with `.NET desktop development` workload.

## Set Up Telerik Development Environment

The fastest way to set up your Telerik development environment is to use the [Telerik CLI](https://www.telerik.com/products/winforms/documentation/installation-and-upgrades/telerik-cli) .NET tool. Run the following commands in your preferred command shell (Visual Studio Terminal, cmd, PowerShell, or other).

> tip If you have already set up your Telerik development environment and it doesn't need updating, skip to [Create a new WinForms Telerik Project](https://www.telerik.com/products/winforms/documentation/getting-started/first-steps#create-new-winforms-telerik-project).

1. Install Telerik CLI

   ```
   dotnet tool install -g Telerik.CLI
   ```

2. Run the `telerik setup winforms` command

   ```
   telerik setup winforms
   ```

The `telerik setup winforms` command performs [multiple Telerik CLI setup steps at once](https://www.telerik.com/products/winforms/documentation/installation-and-upgrades/telerik-cli) to configure your Telerik development environment automatically:

✓ Creates your Telerik account or log in if you already have one.

✓ Activates a Telerik UI for WinForms trial if you don't have an active license.

✓ Downloads your Telerik license key file and saves `telerik-license.txt` to your operating system user's folder, making it available to all Telerik .NET apps on your machine.

✓ Configures the Telerik NuGet package source.

✓ Installs the Telerik MCP server for AI-powered coding assistance.

Now, your Telerik development environment is configured and ready to use!

## Create new WinForms Telerik Project

In this step, create a basic Telerik WinForms project that you can use as a starting point for your application:

1. Open Visual Studio and select **Create a new project** in the start window.

2. Select the **Telerik C# Windows Forms Application** template, and click **Next**. This template creates a .NET project. If you want to create a .NET Framework project, select the **Telerik C# Windows Forms Application (Net Framework)** template instead.

> caption Figure 1: Create a new Telerik WinForms project

![Visual Studio project template picker showing the Telerik C# Windows Forms Application template](https://www.telerik.com/products/winforms/documentation/assets/c86bd270b58fcc9db01301f378b82733/first-steps-create-new-project.png)

> note Telerik project templates are available in C# and VB for .NET and .NET Framework.

## Download Telerik UI for WinForms Controls

> important Starting with **Q3 2026**, all Telerik UI for WPF NuGet packages will be available on [NuGet.org](https://www.nuget.org/). If you install packages from NuGet.org, you do not need to configure the Telerik NuGet server.

The easiest way to get Telerik UI for WinForms controls on your development machine is to [install them with NuGet packages](https://www.telerik.com/products/winforms/documentation/installation-and-upgrades/install-using-nuget) directly from **NuGet Package Manager** in Visual Studio.

1. In Visual Studio, go to **Tools > NuGet Package Manager > Manage NuGet Packages for Solution**.

2. Select the Telerik package source that you added in Step 3.

3. Search for `Telerik.UI.for.WinForms.AllControls`, and install the **Telerik.UI.for.WinForms.AllControls** package.

> caption Figure 3: Install the Telerik.UI.for.WinForms.AllControls package

![NuGet Package Manager showing the Telerik.UI.for.WinForms.AllControls package selected for installation](https://www.telerik.com/products/winforms/documentation/assets/afeafb29aa411e0659c7cc11b6dacc15/first-steps-browse-nuget.png)

> note You can include prerelease versions by selecting the **Include prerelease** checkbox.

After installation, the `Telerik.UI.for.WinForms.AllControls` package appears under **Packages** in Solution Explorer:

> caption Figure 4: Verify the installed Telerik package

![Solution Explorer showing the installed Telerik.UI.for.WinForms.AllControls package under Packages](https://www.telerik.com/products/winforms/documentation/assets/67c159b40efa6e6cedc4450f7380e871/first-steps-installed.png)

## Add a Telerik UI for WinForms Control to the RadForm

After you install Telerik UI for WinForms, the controls appear in the Visual Studio Toolbox. To add a Telerik component, drag it from the Toolbox and drop it onto the form designer surface.

1. Add RadGridView to the RadForm

For this example, let's add the [RadGridView](https://www.telerik.com/products/winforms/documentation/controls/gridview/getting-started) control. Search for **RadGridView** in the Toolbox, and then drag it to the form designer surface.

> caption Figure 5: Add RadGridView from the Toolbox

![Visual Studio Toolbox with RadGridView dragged onto the form designer surface](https://www.telerik.com/products/winforms/documentation/assets/20c62529ac4df7ccfe43173168ccc261/first-steps-add-radgridview.gif)

You can also add components programmatically:

```C#
RadGridView radGridView1 = new RadGridView();
radGridView1.Columns.Add("Column1");
radGridView1.Columns.Add("Column2");
this.Controls.Add(radGridView1);
```

```VB
Dim radGridView1 As New RadGridView()
radGridView1.Columns.Add("Column1")
radGridView1.Columns.Add("Column2")
Me.Controls.Add(radGridView1)
```

2. Next, bind the control to sample data.
3. Press `F5` to build and run the application.

## Next Steps

<article-card-container>
    <article-card
        href="/ai-tools/agentic-ui-generator/overview"
        src="/products/winforms/documentation/assets/1a95789349616f5a96ee349e0f03d262/chat_light_large.svg"
        darkSrc="/products/winforms/documentation/assets/92205189ccd98ce83506bf206bddeeee/chat_dark_large.svg"
        title="Telerik AI Coding Assistant"
        description="Telerik UI for WinForms AI-powered development assistance through a unified MCP server that delivers intelligent, context-aware help directly in your IDE.">
    </article-card>
    <article-card
        href="/ai-tools/agentic-ui-generator/converter/overview"
        src="/products/winforms/documentation/assets/1a95789349616f5a96ee349e0f03d262/chat_light_large.svg"
        darkSrc="/products/winforms/documentation/assets/92205189ccd98ce83506bf206bddeeee/chat_dark_large.svg"
        title="Telerik Converter"
        description="Automatically migrate existing Microsoft WinForms applications to use Telerik RadControls.">
    </article-card>
    <article-card
        href="/introduction#list-of-controls"
        src="/products/winforms/documentation/assets/34f07dcdfb06e61deacd0ae611ead0fe/editor_ai_integration_light_large.svg"
        darkSrc="/products/winforms/documentation/assets/5afbc2e3509e38a68fa2c0e148bc4e84/editor_ai_integration_dark_large.svg"
        title="Use Components"
        description="Check the list of available Telerik WinForms components.">
    </article-card>
    <article-card
        href="https://demos.telerik.com/winforms/"
        src="/products/winforms/documentation/assets/ef4e202163f8ba624ebe354cb8e2552b/grid_ai_chat_integration_light_large.svg"
        darkSrc="/products/winforms/documentation/assets/90e1c198dfd43aaf9faecb945f01dbe0/grid_ai_chat_integration_dark_large.svg"
        title="Browse WinForms Demos"
        description="Explore the examples via the Telerik UI for WinForms Desktop Examples application.">
    </article-card>
    <article-card
        href="/controls/gridview/getting-started"
        src="/products/winforms/documentation/assets/72271b5c70f640266b01ed7c4b13d6a5/data_highlight_light_large.svg"
        darkSrc="/products/winforms/documentation/assets/96fcc5790687fb5ebf46c7fde8006ff9/data_highlight_dark_large.svg"
        title="Get Started with RadGridView"
        description="Bind the Telerik WinForms Data Grid to data and choose from the variety of built-in features.">
    </article-card>
    <article-card
        href="/styling-and-appearance/themes-style"
        src="/products/winforms/documentation/assets/16321f5a65c2a527641999ce3ccfa3a1/themingt_light_large.svg"
        darkSrc="/products/winforms/documentation/assets/fd20d47973fa3004bcf03f1cc2bcbff3/theming_dark_large.svg"
        title="Theming"
        description="Review the built-in themes.">
    </article-card>
</article-card-container>

## See Also

* [System requirements](https://www.telerik.com/winforms/tech-sheets/system-requirements)
* [Download product files](https://www.telerik.com/products/winforms/documentation/installation-and-upgrades/download-product-files)
* [Predefined template applications](https://www.telerik.com/winforms/winforms-guide)
* [Progress Virtual Classroom](https://www.telerik.com/account/support/virtual-classroom)
