> ## 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.

# Label

> A form label that identifies an input field. Always paired with a form control — it's not a general-purpose text element.

## Label

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

### When to use

* Every [Input](/aura-design-system/primitives/input), [Select](/aura-design-system/primitives/select), [Combobox](/aura-design-system/primitives/combobox), [Textarea](/aura-design-system/primitives/textarea), [Checkbox](/aura-design-system/primitives/checkbox) in a group, [Radio](/aura-design-system/primitives/radio) in a group, or similar form control needs one.

### When not to use

* Headings or section titles - use the appropriate heading level.
* Descriptive text below or alongside a field — use [HelperText](/aura-design-system/primitives/helper-text).
* Non-interactive UI labels like status indicators or metadata — use plain text or [Badge](/aura-design-system/primitives/badge).

### Dos and don'ts

* Do always associate a Label with its field via htmlFor / id — this is what makes it accessible, not just visual.
* Do mark required fields consistently across the form, either with an asterisk or explicit text.
* Don't use placeholder text as a substitute for a label — placeholders disappear on input and aren't accessible.
* Don't hide labels to create a "cleaner" layout — if space is tight, use [Tooltip](/aura-design-system/primitives/tooltip) to supplement a shortened label, not replace it.
* Don't disable a label independently of its field — their states should always match.

### Often used with

* Exactly one associated control: [Input](/aura-design-system/primitives/input), [Textarea](/aura-design-system/primitives/textarea), [Select](/aura-design-system/primitives/select), [Combobox](/aura-design-system/primitives/combobox), [Checkbox](/aura-design-system/primitives/checkbox), [Radio](/aura-design-system/primitives/radio), [Switch](/aura-design-system/primitives/switch), [Slider](/aura-design-system/primitives/slider), [Date and time picker](/aura-design-system/primitives/date-and-time-picker), or [File upload](/aura-design-system/primitives/file-upload).