# Text inputs

Use this page when the user types content and the main decision is whether the field should stay generic, become multiline, or adopt a specialized entry contract.

## Quick Decision Rules

- Use [TextField](https://vega-ui.dev/components/text-field/) for generic single-line text.
- Use [TextArea](https://vega-ui.dev/components/text-area/) for multiline prose.
- Use [PasswordField](https://vega-ui.dev/components/password-field/) for masked secret entry.
- Use [NumberField](https://vega-ui.dev/components/number-field/) for exact numeric values with stepping or bounds.
- Use [PhoneField](https://vega-ui.dev/components/phone-field/) for country-aware phone entry.
- Use [PinField](https://vega-ui.dev/components/pin-field/) for short fixed-length verification codes.

## By Value Model

- Generic single-line text: [TextField](https://vega-ui.dev/components/text-field/)
- Multiline text: [TextArea](https://vega-ui.dev/components/text-area/)
- Secret string: [PasswordField](https://vega-ui.dev/components/password-field/)
- Numeric quantity: [NumberField](https://vega-ui.dev/components/number-field/)
- Phone number: [PhoneField](https://vega-ui.dev/components/phone-field/)
- OTP or PIN code: [PinField](https://vega-ui.dev/components/pin-field/)

## Common Misclassifications

- Do not use [TextField](https://vega-ui.dev/components/text-field/) once masking, phone parsing, number stepping, or secret reveal become part of the field contract.
- Do not use [TextArea](https://vega-ui.dev/components/text-area/) for short single-line values.
- Do not use [NumberField](https://vega-ui.dev/components/number-field/) for identifiers or codes that only happen to contain digits.
- Do not use [PinField](https://vega-ui.dev/components/pin-field/) for free-form secrets or generic text.

## Supporting Pieces

- Use [Label](https://vega-ui.dev/components/label/) for one field label.
- Use [HelperText](https://vega-ui.dev/components/helper-text/) for short field-adjacent guidance.
- Use [Fieldset](https://vega-ui.dev/components/fieldset/) when several fields belong to one named group.