Skip to main content

Layout

Tiles

Visual-heavier grid of clickable tiles for landing pages and category hubs.

Usage

<Tiles cols={3}>
  <Tile title="Quickstart" description="5-minute setup" href="/quickstart" icon="rocket" />
  <Tile title="Components" description="30+ MDX components" href="/components/callout" icon="layers" />
  <Tile title="API Reference" description="Complete REST API" href="/api-reference/introduction" icon="code" />
</Tiles>

<Tiles> is a responsive grid of <Tile> cards. Each tile is centered, icon-first, and clickable as a single unit.

Tiles vs Cards

<Tiles> / <Tile><Card> / <CardGroup>
Visual weightHeavy — large icon plate, centeredLight — left-aligned, dense
Best forLanding pages, "pick your starting point"Feature grids, dense info
Required hrefYesNo (optional)
DescriptionCentered, smallerLeft-aligned

Use Tiles when you have 3-6 high-level entry points and want each to feel like a poster. Use Cards when you have many items and want density.

4 tiles

<Tiles cols={4}>
  <Tile title="Free" icon="user" href="/pricing" />
  <Tile title="Pro" icon="zap" href="/pricing" />
  <Tile title="Business" icon="trophy" href="/pricing" />
  <Tile title="Enterprise" icon="shield" href="/pricing" />
</Tiles>

Custom icon color

Override the default primary tint per tile:

<Tiles cols={3}>
  <Tile title="Stable" icon="check" color="var(--docs-success)" href="/" />
  <Tile title="Beta" icon="zap" color="var(--docs-warning)" href="/" />
  <Tile title="Experimental" icon="sparkles" color="var(--docs-danger)" href="/" />
</Tiles>

Props

Tiles

PropTypeDefaultDescription
cols2 | 3 | 43Number of columns on desktop
childrenReactNoderequiredOne or more <Tile>

Tile

PropTypeRequiredDescription
titlestringYesTile heading
hrefstringYesLink destination
descriptionstringNoSubtitle below the title
iconstringNoLucide icon name or emoji
colorstringNoOverride the icon tint (CSS color or var)
Was this page helpful?

Last updated August 11, 2026