# Status and feedback

Use this page when the UI should communicate state, loading, progress, measurement, or identity display and the main choice is between compact metadata, feedback messaging, or quantitative indicators.

## Quick Decision Rules

- Use [Badge](https://vega-ui.dev/components/badge/) for compact status or category metadata.
- Use [Alert](https://vega-ui.dev/components/alert/) for short semantic feedback messages.
- Use [Spinner](https://vega-ui.dev/components/spinner/) for compact indeterminate loading.
- Use [Progress](https://vega-ui.dev/components/progress/) for temporal completion.
- Use [Meter](https://vega-ui.dev/components/meter/) for bounded descriptive measurement.
- Use [MeterStack](https://vega-ui.dev/components/meter-stack/) when one measurement is composed of meaningful parts.
- Use [Avatar](https://vega-ui.dev/components/avatar/) for one person or entity identity surface.
- Use [AvatarStack](https://vega-ui.dev/components/avatar-stack/) for a compact group identity signal.

## By Meaning

- Compact metadata: [Badge](https://vega-ui.dev/components/badge/)
- Short feedback message: [Alert](https://vega-ui.dev/components/alert/)
- Unknown-duration loading: [Spinner](https://vega-ui.dev/components/spinner/)
- Known or bar-like completion: [Progress](https://vega-ui.dev/components/progress/)
- Bounded score, capacity, or level: [Meter](https://vega-ui.dev/components/meter/)
- Segmented composition breakdown: [MeterStack](https://vega-ui.dev/components/meter-stack/)
- One identity: [Avatar](https://vega-ui.dev/components/avatar/)
- Group identity preview: [AvatarStack](https://vega-ui.dev/components/avatar-stack/)

## Common Misclassifications

- Do not use [Badge](https://vega-ui.dev/components/badge/) for full messages that need hierarchy or explanation.
- Do not use [Alert](https://vega-ui.dev/components/alert/) as a neutral layout container.
- Do not use [Spinner](https://vega-ui.dev/components/spinner/) when exact progress is known.
- Do not use [Progress](https://vega-ui.dev/components/progress/) for static scores or quotas.
- Do not use [Meter](https://vega-ui.dev/components/meter/) for async completion.
- Do not use [AvatarStack](https://vega-ui.dev/components/avatar-stack/) when explicit names or roles matter more than compactness.

## Start Here

- Feedback near content or forms: [Alert](https://vega-ui.dev/components/alert/), [Badge](https://vega-ui.dev/components/badge/)
- Loading states: [Spinner](https://vega-ui.dev/components/spinner/), [Progress](https://vega-ui.dev/components/progress/)
- Metrics and usage displays: [Meter](https://vega-ui.dev/components/meter/), [MeterStack](https://vega-ui.dev/components/meter-stack/)
- Identity surfaces: [Avatar](https://vega-ui.dev/components/avatar/), [AvatarStack](https://vega-ui.dev/components/avatar-stack/)