---
title: Getting Started
description: 'Get started with the KendoReact Upload package and learn how to use the Upload component in React projects.'
components: ['upload']
slug: get_started_upload
position: 1
---
# Getting Started with the KendoReact Upload
This guide provides essential information about using the KendoReact Upload package—you will learn how to install the Upload package, add a Upload component to your project, style the component, and activate your license.
After completing this guide, you will be able to reproduce the following example.
{% meta height:150 %}
{% embed_file get-started/func/app.tsx preview %}
{% embed_file get-started/func/main.tsx %}
{% endmeta %}
## Before You Begin
To follow the steps in this guide, you need to have a React project set up. If you don't have one, you can create a new React application using Vite by running the following command in your terminal:
```sh
npm create vite@latest my-app -- --template react
```
This guide requires that you have **basic knowledge of React and TypeScript**, and that you have already created [**a blank React project**](slug://getting_started).
> tip You can speed up the development of your KendoReact application with the [Kendo UI Template Wizard for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=KendoUI.kendotemplatewizard).
## Install the Component
To install the Upload package, run the following command in the root folder of your React project:
```sh
npm i @progress/kendo-react-upload
```
## Importing the Component
After installing the package, import the Upload component in the React App.
In the `src/App.js` file of your React project, import the `Upload` component from the Upload package.
```jsx-no-run
// ES2015 module syntax
import { Upload } from "@progress/kendo-react-upload";
```
```jsx-no-run
// CommonJS format
const { Upload } = require('@progress/kendo-react-upload');
```
## Using the Component
1. Define the `URLs` that you will use to save and remove files.
```jsx
const saveUrl = 'https://demos.telerik.com/service/v2/odata/upload/save';
const removeUrl = 'https://demos.telerik.com/service/v2/odata/upload/remove';
```
1. Add the component's markup to the `src/App.js` file in your project, and add the initial collection of files, if any.
```jsx
return ;
```
1. To style the Upload, install and import the [Default theme](https://www.telerik.com/design-system/docs/themes/kendo-themes/default/), which is one of the [three beautiful themes]({% slug themesandstyles %}) for KendoReact.
3.1. Install the Default theme package.
```sh
npm i @progress/kendo-theme-default
```
3.2. Import the CSS file from the package in `src/App.js`. Add this import before your existing `App.css` import.
```jsx
import '@progress/kendo-theme-default/dist/all.css';
```
1. Build and run the application by typing the following command in the root folder of your project:
```sh
npm start
```
1. Navigate to to see the KendoReact Upload component on the page.
## Activating Your License Key
Using any of the UI components in the KendoReact library requires either a commercial license key or an active trial license key.
Follow the instructions on the KendoReact [My License page]({% slug my_license %}) to activate your trial or commercial license. You can skip this step if your application already contains a KendoReact license file.
## Dependencies
The Upload package requires you to install the following [peer dependencies](https://nodejs.org/en/blog/npm/peer-dependencies/) in your application:
| Package Name | Description |
| ------------------------- | ---------------------------------------------------------------- |
| react 18.0.0\* | Contains the functionality necessary to define React components. |
| react-dom | Contains the React renderer for the web. |
| @progress/kendo-licensing | Contains the internal infrastructure related to licensing. |
| @progress/kendo-svg-icons | Contains the KendoReact SVG icons. |
## Suggested Links
- [Disabled Upload]({% slug disabledstate_upload %})
- [Modes of operation]({% slug controleduncontroled_upload %})
- [Credentials and additional data]({% slug credentials_upload %})
- [File processing]({% slug fileprocessing_upload %})
- [File restrictions]({% slug filerestrictions_upload %})
- [Dragging and dropping]({% slug drag_and_drop %})
- [Action Buttons]({% slug actionbuttons_upload %})
- [Custom rendering]({% slug rendering_upload %})
- [External Drop Zone]({% slug external_drop_zone %})
- [Globalization]({% slug globalization_upload %})
- [Keyboard navigation]({% slug keyboard_navigation_upload %})
## Learning Resources
- [Getting Started with KendoReact]({% slug getting_started %})
- [Virtual Classroom (Introductory Course Available to Trial and Commercial License Holders)](https://learn.telerik.com/learn/course/external/view/elearning/14/kendoreact)
- [Explore the Finance Portfolio Sample Application](https://www.telerik.com/kendo-react-ui/components/sample-applications/finance-application/)
- [Explore the Coffee Warehouse Sample Application](https://www.telerik.com/kendo-react-ui/components/sample-applications/react-coffee-warehouse-dashboard/)
- [Explore the Github Issues Grid Sample Application](https://www.telerik.com/kendo-react-ui/components/sample-applications/issues-grid/)