> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Input

> Use the Aura Input primitive for short text in forms and toolbars, with support for labels, helper text, prefixes, and validation states.

## Input

<Badge color="blue">v1.0.0</Badge> | [View in Storybook](https://master--695bb4b1b8041ae09768950a.chromatic.com/?path=/docs/primitives-input--docs) · [View in Storybook](https://master--695bb4b1b8041ae09768950a.chromatic.com/?path=/docs/primitives-input-group--docs)

### When to use

* Use Input fields when you need users to provide specific text-based information, such as assets, name, or other detailed data, which will be processed or stored.
* Use Input fields in forms or for entering credentials like usernames, passwords, or email addresses.

### When to use something else

* If users need to choose from a predefined set of options, consider [Select](/aura-design-system/primitives/select), [Combobox](/aura-design-system/primitives/combobox), [Checkbox](/aura-design-system/primitives/checkbox), or [Radio](/aura-design-system/primitives/radio).
* If the user can add options or benefits from suggestions while typing, consider [Combobox](/aura-design-system/primitives/combobox).
* For date and time input, use [Date and time picker](/aura-design-system/primitives/date-and-time-picker) primitives.
* For long text such as descriptions, use [Textarea](/aura-design-system/primitives/textarea).

### Dos and don'ts

* Don't use long placeholder descriptions that repeat the label name.
* Don't repeat the label in placeholder copy.
* Don't use placeholder text that could be misunderstood as pre-filled text.
* Don't wrap text. Truncate or use a [Textarea](/aura-design-system/primitives/textarea) instead.
* Don't use any default filled text as users may overlook it.

### Anatomy

* Leading content: Optional content that appears to the left of the input field. It is not recommended to use multiple leading content items unless it is absolutely necessary.
  * Icon: An optional icon that appears to the left of the input field to help the user understand the context of the input.
  * Prefix: An optional, fixed formatted text that appears to the left of the input field, e.g., a currency symbol.
* Trailing content: Optional content that appears to the right of the input field. It is not recommended to use multiple trailing content items unless it is absolutely necessary.
  * Button: Helpful for quick actions related to the input, e.g., 'Copy' or 'Search'. A tooltip may be helpful to explain the action.
  * Suffix: An optional, fixed formatted text that appears to the right of the input field, e.g., a unit of measurement.
  * Stepper: Allows the user to increment or decrement a value by a fixed amount.
  * Shortcut: Helpful shortcut key related to the input, e.g., 'Ctrl + C' for 'Copy'. A [Tooltip](/aura-design-system/primitives/tooltip) may help explain the shortcut.

### Behavior

* Value updates as the user types unless using a masked or controlled pattern; validation messages should associate with the field for assistive tech.
* Single-line only: use [Textarea](/aura-design-system/primitives/textarea) when line breaks are expected.

### Often used with

* [Label](/aura-design-system/primitives/label), [Helper text](/aura-design-system/primitives/helper-text); input-group layout (leading icon, prefix, suffix, trailing [Button](/aura-design-system/primitives/button)) per [Anatomy](#anatomy); [Tooltip](/aura-design-system/primitives/tooltip) on trailing icon [Button](/aura-design-system/primitives/button)s.