# Category Browse Grid block

> Shop by Category Grid with Hover Browse Buttons and Badges

Four-column image grid for browsing product categories. Each card has a photo with hover-reveal browse button, optional badge, name, and item count. ReUI Badge, shadcn Button, Breadcrumb. Shop-by-category, product taxonomy, ecommerce catalog.

- Type: Pro block
- Category: [Category Card](https://web.dev.reui.io/blocks/ecommerce/category-card.md)
- Page: https://web.dev.reui.io/blocks/ecommerce/category-card/category-card-1
- MCP: `get_block("category-card-1")`
- Built with: Badge, Breadcrumb, Button
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

A centered heading over a 4 column photo grid with item counts and blurbs, where a Browse button slides up over each image on hover

## Agent notes

- `itemCount` is a preformatted display string such as 128 items, so format your catalog counts as text before they fill the `Category` shape
- `badge` is optional per category and takes a ReUI Badge `variant`; only 3 of the 8 samples in `categories` set one
- The breadcrumb and the Shop By Category heading are literal text in `CategoryCard`, not read from `categories`

## When not to use

- Items for sale on tiles that each carry a price and an add to cart button: use [Add-to-Cart Grid](https://web.dev.reui.io/blocks/ecommerce/product-grid/product-grid-3.md) (`get_block("product-grid-3")`)

## Install

```bash
npx shadcn@latest add @reui/category-card-1
```

## About Category Card blocks

### When to use

- A shop by category section that sends shoppers from a photo into a department or collection
- Collection and catalog landing pages: a featured department, curated guides or seasonal edits
- A collections browse page that shoppers search, filter, sort and page through

### When not to use

- Individual items for sale on tiles, each with its own price and buy or wishlist controls: use the [Product Card blocks](https://web.dev.reui.io/blocks/ecommerce/product-card.md)
- Dashboard tiles for KPIs, records or setup guides, away from any storefront: use the [Card blocks](https://web.dev.reui.io/blocks/application/card.md)
- Rows of funds, transactions or integrations, each with a figure or a connect button: use the [List blocks](https://web.dev.reui.io/blocks/application/list.md)

### Agent notes

- `CategoryCard` takes no props and renders the arrays in its data module; add a prop to pass in your own categories
- Every `href` in the data module is a hash placeholder and every `image` points at an Unsplash demo photo; swap in your routes and photos
- Each page.tsx centers `CategoryCard` in a padded `min-h-svh` wrapper; drop it inside your own storefront layout

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.