---
title: "custom file input · RUAL Documentation"
description: "Custom HTML file input element"
canonical: https://docs.rual.nl/block-types/Component%20UI/component_custom_input_file
language: en
---

[Cluster](https://docs.rual.nl/cluster)

[Blocks](https://docs.rual.nl/block-types)

[Interfaces](https://docs.rual.nl/interfaces)

[Blueprints](https://docs.rual.nl/blueprints)

[Tutorials](https://docs.rual.nl/tutorials)

[Home automation](https://docs.rual.nl/home-automation)

[Examples](https://docs.rual.nl/examples)

[Reference](https://docs.rual.nl/reference)

[Architecture](https://docs.rual.nl/architecture)

[Troubleshooting](https://docs.rual.nl/troubleshooting)

Other

# custom file input

This block is part of the [`Component UI`](https://docs.rual.nl/block-types/Component%20UI) group and was last modified in core [`v11.0.1`](https://docs.rual.nl/core-versions/110001).

Custom HTML file input element

- Field required `fielddefinitions` Field to save the value in

- Validate `fieldvalidation` Applies the given validation to the element, overwrites attributes given in the attributes popup

- Event `inputevent`

- Button Text `value` Your custom text that will show as your label

- Empty File Text `value` Custom text when no file is selected

- max file size `number` max file size in bytes

- uicomponent `uicomponent`

A typical wiring for [custom file input](https://docs.rual.nl/block-types/Component%2520UI/component_custom_input_file): [combine](https://docs.rual.nl/block-types/fields/fielddefinitions_multiple) feeds the `co-fields` pin; the `uicomponent` out pin feeds [build PDF](https://docs.rual.nl/block-types/files/file_generate_pdf).

[![Studio canvas example for the custom file input block: typical wiring for custom file input.](https://docs.rual.nl/canvas-examples/component_custom_input_file.png)](https://docs.rual.nl/canvas-examples/component_custom_input_file.png?v=3)

## Version history

Introduced in [`v11.0.1`](https://docs.rual.nl/core-versions/110001).

- [Back to `Component UI`](https://docs.rual.nl/block-types/Component%20UI): Return to the main group to view all sub-groups

- [Back to `form`](https://docs.rual.nl/block-types/Component%20UI?group=form): Return to the group to view all blocks within this group

Was this page helpful? [Tell us what to improve](https://docs.rual.nl/support) · RUAL Docs is an integral component of the [RUAL ecosystem](https://rual.nl)