> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/componentes/file-uploader-cargador-de-archivos.md).

# File upload - FileUploader

User guide for `facephi-file-uploader-widget` provided by the SDK Web.

Type: `HTMLFacephiFileUploaderWidgetElement`

***

### How it works

The web component `facephi-file-uploader-widget` of the SDK Web is designed to manually upload documents to the platform and process them in the *backend*. This guide provides a detailed description of its properties and integration options.

{% hint style="warning" %}
**Warning**: This component needs tracking to be enabled to work. If the property `disabled` in the `<facephi-sdk-provider>` in `true`, the component will not complete the file upload.
{% endhint %}

### Integration Example

```jsx
<facephi-sdk-provider apikey={process.env.FACEPHI_SDK_APIKEY}>
    <facephi-file-uploader-widget
        maxFiles={2}
        maxFileSize={10}
    />
</facephi-sdk-provider>
```

***

### Configuration

The Widget can be configured with the following properties

{% content-ref url="/pages/81c6b36b2a1607aae41dcce512e3f7837a22ba41" %}
[Properties](/docs.facephi-en/sdks/sdk-web/componentes/file-uploader-cargador-de-archivos/propiedades.md)
{% endcontent-ref %}

The File Uploader component will emit events during its lifecycle.

{% content-ref url="/pages/b58e7b168a73715307edb60f39b5b69f334b5fd5" %}
[Events](/docs.facephi-en/sdks/sdk-web/componentes/file-uploader-cargador-de-archivos/eventos.md)
{% endcontent-ref %}

***

### Benefits of Using File Uploader

* Upload unsupported documents: By filtering documents by allowed types, such as *jpeg* or *png*, documents that are not compatible with SelphID can be uploaded to the platform for processing.
* Customizable Flow: Configure the allowed document types, the number, and the size of the files.

By leveraging the capabilities of the `facephi-file-uploader-widget`, you can implement a robust and easy-to-configure document upload solution.