# Data Refresh State

> An accessible status indicator that shows the lifecycle of a data source — idle, checking, refreshing, partially updated, success, stale, offline, error, paused, or cancelled — with manual refresh, cancel, retry, pause/resume, and auto-refresh interval controls for dashboards and data widgets.

- Author: [Mehi](https://21st.dev/@rmahammad)
- Library: [Motiq](https://21st.dev/@rmahammad/library/motiq)
- License: MIT
- Tags: Dashboard
- npm dependencies: motion
- Live preview: https://21st.dev/@rmahammad/components/data-refresh-state

## Install

```bash
npx shadcn@latest add "https://21st.dev/r/rmahammad/data-refresh-state?api_key=$API_KEY_21ST"
```

Requires a 21st API key (generate one at https://21st.dev/mcp) passed as `API_KEY_21ST`. Free accounts get a limited number of installs per day; unlimited on a paid plan — see https://21st.dev/pricing.

Full component directory: https://21st.dev/llms.txt · More like this: https://21st.dev/community/components/s/dashboard.md
