# Orders Table

> A store's orders list: headline figures, tabs for what needs doing (unfulfilled, unpaid, open) with counts, search across orders, customers and products, and separate payment and fulfillment badges. Hover the product stack to see line items. Select orders to fulfil, capture, print or archive them in bulk; the order column stays pinned when the table scrolls sideways.

- Slug: `orders-table`
- Category: [Tables](https://www.assembli.design/category/tables.md)
- Type: component
- Tags: table, orders, ecommerce, commerce, fulfillment, payments, bulk-actions, admin
- npm dependencies: @base-ui/react, motion, lucide-react
- shadcn/ui dependencies: none
- Live preview: https://www.assembli.design/preview/orders-table
- Page: https://www.assembli.design/components/orders-table

![Orders Table preview](https://www.assembli.design/thumbnails/orders-table-light.png)

## Props

Other props pass through to the root element.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `defaultOrders` (required) | `Order[]` |  |  |
| `currency` | `string` | `"USD"` |  |
| `pageSize` | `number` | `10` |  |
| `stats` | `{ label: string; value: string; delta?: number }[]` |  | Small figures above the table. |

## Install

One-time setup (needs a subscription):

1. Add the registry to the project's `components.json`: `{"@assembli":{"url":"https://www.assembli.design/r/{name}.json","headers":{"Authorization":"Bearer ${ASSEMBLI_API_KEY}"}}}` (merge into `"registries"`).
2. Put an API key from https://www.assembli.design/account in `.env.local` as `ASSEMBLI_API_KEY=asm_…`.

Then install with the shadcn CLI (writes `components/orders-table/orders-table.tsx` and installs dependencies):

```bash
npx shadcn@latest add @assembli/orders-table
```

Registry item JSON: https://www.assembli.design/r/orders-table.json (send `Authorization: Bearer <api key>`)

## Code

> Component source needs an Assembli subscription ($12/month or $96/year) and an API key sent as `Authorization: Bearer <key>`. To get one without copying anything, POST https://www.assembli.design/api/agent/login (or call the MCP tool connect_account), show the user the link it returns, and poll https://www.assembli.design/api/agent/token for the key. Or subscribe at https://www.assembli.design/pricing and create a key at https://www.assembli.design/account.