# Upload

The `Upload` control allows users to select files from their local machine and upload them to the server. The files are available in the `Uploaded` event as a `HttpFileCollection`.

{% hint style="info" %}
For a full list of properties, methods and events see the [API documentation.](http://docs.wisej.com/api)
{% endhint %}

## Features

### Capture Mode

The `CaptureMode` property contains several configuration options for defining the type of user input:

* `Default`: The default upload configuration.
* `User`: Specifies that the upload operation should show a user-facing camera and microphone.
* `Environment`: Specifies that the upload operation should show an environment-facing camera and microphone.

![Upload control showing capture mode options](/files/-MeAzWLdyFiq4Bge-Omg)

{% hint style="warning" %}
The `CaptureMode` property works better on mobile devices; if your device is a desktop computer, you'll likely get a typical file picker.
{% endhint %}

### Filter File Types

The `AllowedFileTypes` property of the `Upload` control specifies the required media types for file selection.

Some examples include:

* `audio/*`: Meaning "any audio file"
* `video/*`: Meaning "any video file"
* `image/*`: Meaning "any image file"

![Upload control with AllowedFileTypes set to image/\* showing file type filtering](/files/-MeAyVGP9JKUOKiMSDqa)

{% hint style="info" %}
The property takes its value as a string containing one or more unique file type specifiers, separated by commas.
{% endhint %}

### Multiple File Selection

When the `AllowMultipleFiles` property is set to `true`, more than one file can be selected for upload.

![Upload control demonstrating multiple file selection capability](/files/-MeAzoD2dmwulsUJnNLg)

## How To

### Customize the Appearance

The `Upload` control can be customized using the `AppearanceKey`, `Font`, and `Color` properties.

#### Appearance Key

The `Upload` control can be customized to show any predefined theme appearance by setting the `AppearanceKey` property.

#### Font

Like most other controls in Wisej.NET, the `Upload` control has a `Font` property that allows for customization of the size, features, and style of font.

![Upload control showing custom font settings](/files/-MgfwzBPoqSnuBmSH9_u)

#### Color Properties

The `Upload` control has a `ForeColor` and `BackColor` property that can specify the color for the text and container, respectively.

![Upload control demonstrating color customization options](/files/-MgfwJ7prmBxqbupmktQ)

## Advanced

### JavaScript Widget

| Item             | Description                                                                                                         |
| ---------------- | ------------------------------------------------------------------------------------------------------------------- |
| Class name       | "wisej.web.Upload"                                                                                                  |
| Theme appearance | "upload", see [Themes](https://docs.wisej.com/theme-builder/theme-elements/elements).                               |
| Child components | "button" is the upload button. "textfield" is the section of the control that holds the file names.                 |
| Source code      | [https://github.com/iceteagroup/wisej-js](https://github.com/iceteagroup/wisej-js/blob/master/wisej.web.TextBox.js) |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wisej.com/docs/controls/content/upload.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.