> For the complete documentation index, see [llms.txt](https://docs.acho.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acho.io/app-builder/app-construction/elements/form-elements/input.md).

# Input

Input boxes take in simple user input as a string.

<figure><img src="https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_fx7PCUqvFEdrucJC%2Fuploads%2FMl7bI9UcU2lUohcpE2ch%2Fimage.png?alt=media&amp;token=3c026334-d30e-44e8-a5e4-3fc69ef21cee" alt=""><figcaption></figcaption></figure>

## Properties

<figure><img src="https://3574406564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB_fx7PCUqvFEdrucJC%2Fuploads%2FuCK60XPTxF7v24XBLFCe%2Fimage.png?alt=media&amp;token=6584c846-a2e6-490d-86b9-53ba783add1d" alt=""><figcaption></figcaption></figure>

**Form item name:** This is the name that the encompassing form will use to access the output of the checkbox. See [Custom Form](/app-builder/app-construction/elements/form-elements/custom-form.md) for how it's used.

**Input type:** Select the input type that users will be expected to input.

**Default value:** The default value to output if the user does not input anything.

**Max length:** Maximum number of characters a user will be able to input.

**Show word limit:** Show the ratio of characters inputted / total characters allowed.

**Clearable:** Will the user be able to clear their input?

**Input placeholder:** Placeholder text to be displayed. Note that the input will not take on this value, as oppposed to the default value.

**Size:** Select a size for the input element.

See [Form Check](/app-builder/app-construction/elements/form-check.md) for data validation.

See [Tooltip](/app-builder/app-construction/elements/tooltip.md) for tooltip configurations.

## Output

The output of this element is set using Input type in properties.

## Supported Events

**Focus:** Triggered when a user selects the input.

**Blur:** Triggered when a user deselects the input (clicks outside).

**Value input:** Triggered when a user types in the input.

**Value change:** Triggered when a user changes the value of the input and either the input is deselected or users press Enter.

**Press enter:** Triggered when users press Enter when in the input.

## Supported Actions

**Set Value:** Set the output value.

**Get Value:** Get the value of the input.

**Set Validate Result:** Set whether the input is valid.

**Set Data:** Change element data. See [Data Store](/app-builder/app-construction/data-store.md).

**Set Loading:** Set loading animation. See [Set loading animations](/app-builder/popular-use-cases/set-loading-animations.md).

{% hint style="info" %}
Visit [Interactions](/app-builder/app-construction/interactions.md) for more on events and actions.
{% endhint %}