# Data Import Start block

> Records empty state with stacked-cards illustration, dual primary actions, and quick-guide link rows

First-run empty state for a records or workspace table: stacked-cards illustration, Connect source and Upload CSV buttons, plus a two-up Quick guides list. Uses shadcn Empty, Button, and Item. Use for zero-data, onboarding, or no results screens.

- Type: Pro block
- Category: [Empty State](https://web.dev.reui.io/blocks/application/empty-state.md)
- Page: https://web.dev.reui.io/blocks/application/empty-state/empty-state-1
- Docs (Base UI): https://ui.shadcn.com/docs/components/base/empty.md
- Docs (Radix UI): https://ui.shadcn.com/docs/components/radix/empty.md
- MCP: `get_block("empty-state-1")`
- Built with: Button, Empty, Item
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

A data import first run offering a live source or a CSV upload, with 2 help guide links underneath

## Agent notes

- Connect source and Upload CSV are `Button`s with no handler; Upload CSV needs your own file input and parser
- Replace the 2 `LearnMoreGuides` rows, How records work and CSV setup, with links to your own import docs
- `RecordsEmptyIllustration` also takes `variant` set to `compact`, a 64px wide version the block never renders

## When not to use

- A search that matched nothing, with suggested queries to run next: use [No Search Results](https://web.dev.reui.io/blocks/application/empty-state/empty-state-2.md) (`get_block("empty-state-2")`)
- A workspace with no projects yet, offering templates to start from: use [First Project](https://web.dev.reui.io/blocks/application/empty-state/empty-state-3.md) (`get_block("empty-state-3")`)

## Install

```bash
npx shadcn@latest add @reui/empty-state-1
```

## About Empty State blocks

### When to use

- A first run screen for records, projects, reports or a library that holds nothing yet
- A search with zero matches or an export page that has nothing to download yet
- A setup prompt to invite the team, enable a feature or connect file storage

### When not to use

- A compact no data message placed inside a table, list or panel you already have: use [Empty](https://web.dev.reui.io/components/empty.md) (`get_component("empty")`)
- Only the layered isometric illustration, with no title, copy or actions: use [Icon Stack](https://web.dev.reui.io/components/icon-stack.md) (`get_component("icon-stack")`)
- A populated tile that shows stats, a profile, links or an integration: use the [Card blocks](https://web.dev.reui.io/blocks/application/card.md)

### Agent notes

- `EmptyState` takes no props in every block, so its copy, media and actions are fixed in the block files; add props to reuse it
- Every page.tsx centers `EmptyState` in a `min-h-svh` wrapper with padding; drop that wrapper inside your own layout
- No action is wired: buttons have no `onClick` or only fire a sonner `toast`, and every `href` is a hash anchor

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