# Shadcn Basic

> Basic label.

- Type: example, free and open source (MIT)
- Component: [Label](https://reui.io/components/label.md)
- Page: https://reui.io/components/label/c-label-1
- Docs (Base UI): https://ui.shadcn.com/docs/components/base/label.md
- Docs (Radix UI): https://ui.shadcn.com/docs/components/radix/label.md
- MCP: `get_example("c-label-1")`
- Registry item: https://reui.io/r/styles/base-nova/c-label-1.json
- Uses: Field, Input, Label

## Best for

The bare pairing of a Username name over one text input, with no marks, hints or states

## When not to use

- A multi line message or comment box under the name: use [Textarea](https://reui.io/components/label/c-label-3.md) (`get_example("c-label-3")`)

## Install

```bash
npx shadcn@latest add @reui/c-label-1
```

## About Shadcn Label

### When to use

- Visible names for text inputs, text areas and checkboxes, each tied to its control by id
- Marks beside the field name: required or optional, a status badge or dot, an info tooltip or an edit toggle
- Field states and hints around the name: disabled, invalid, helper text under it and a live character count

### When not to use

- Form rows that need hint and error slots, grouped sets or a side by side layout: use [Field](https://reui.io/components/field.md) (`get_component("field")`)
- The text box itself, with typed entry for email, password, number or file: use [Input](https://reui.io/components/input.md) (`get_component("input")`)
- Lists of tick boxes, a mixed state or selectable cards with a ticked state: use [Checkbox](https://reui.io/components/checkbox.md) (`get_component("checkbox")`)

### Agent notes

- Every `htmlFor` and its matching `id` is a fixed string such as `label-required`; make each pair unique when a field renders more than once
- `data-disabled` on `Field` does not dim a plain `Label`, whose dim rule needs an unnamed `group` ancestor while `Field` is a named group

Every ReUI item has a twin like this one; the index is https://reui.io/llms.txt. Agents with the ReUI MCP (https://reui.io/docs/mcp) get the same guidance from the getters named above.