Cards and tiles
Use cards for high-value links and tiles for dense visual grids, with icons, images, CTAs, arrows, and callout-style variants.
Cards and tiles guide navigation. Use cards when a few choices need explanation. Use tiles when the reader is scanning a grid of concepts, components, platforms, or next pages.
Do not nest cards
A card or tile should be the surface. Do not put cards inside cards or tiles inside cards. If a section feels crowded, split it into a heading, short text, and one grid.
Cards
Offers overview
Learn the checkout surface before adding identity, timers, or backend automation.
API reference
Review endpoint headers, fields, request examples, and response examples.
<CardGroup cols={2}>
<Card title="Offers overview" icon="package" href="/docs/offers/overview" cta="Open Offers">
Learn the checkout surface before adding identity or automation.
</Card>
<Card title="API reference" icon="braces" href="/docs/api/reference" arrow>
Review endpoint headers, fields, request examples, and responses.
</Card>
</CardGroup>
Card variations
Horizontal card
Use horizontal when the card should read as a compact row.
Typed warning
Use type for callout-style card states.
Image card
Use img when the card benefits from a real product or docs preview.
Tiles
Card properties
titlestringrequiredThe primary card heading.
iconstring | URL | SVGAdds a visual marker. Linked cards should almost always include one.
hrefstringTurns the card into a link.
horizontalbooleandefault: falseUses a compact row layout.
img | imgMediaIdstringAdds a preview image at the top of the card.
alt | imgAltstringAccessible alternative text for image cards.
ctastringCustomizes the action text.
arrowbooleanForces or hides the arrow affordance.
typeinfo | warning | note | tip | check | dangerApplies callout-style color and icon treatment.
Tile properties
titlestringrequiredThe tile label.
hrefstringTurns the tile into a link.
descriptionstringAdds supporting text beneath the title.
childrenReactNodeInline tile body content. Use this when the description needs links or formatted text.
iconstring | URL | SVGAdds an icon. Every linked navigation tile should include one.
img | imgMediaIdstringAdds a visual preview for component or screenshot tiles.
Group properties
cols | columns1 | 2 | 3 | 4default: 3Sets the responsive column count for CardGroup or TileGroup.
gapsm | md | lgdefault: mdControls spacing between cards or tiles.
variantdefault | compact | layer | previewSelects the tile visual treatment. Use layer for the Kumo-style layer cards the docs use for dense navigation grids.