/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
Components Section cards

Section cards

SectionCards lists your site's sections as cards, in your preset's home style.

2 min read

<SectionCards> draws one card per section of your site, each listing its first pages — the section grid of a docs home. It's drawn by your preset's own home builders, so it looks native in all eight.

Note

Doc engine v2 only (presets). A v1 site doesn't draw <SectionCards>: used empty it shows nothing, and any content inside it shows as plain text.

Used empty

mdx
<SectionCards />

With no children, it draws one card per header section, listing its first pages and how many there are. On a site with one section, it draws one card per sidebar group instead.

Used empty, it fills itself from your site. Give it content of its own and it shows only that. With no content and nothing on the site to fill it, it draws nothing and the build log says so:

text
<SectionCards>: the site has no sections to list, so it shows nothing. Give it content or remove it.

With your own content

mdx
<SectionCards title="Start with a product">
<Card title="Payments" href="/payments">
- [Accept a payment](/payments/accept)
- [Refunds](/payments/refunds)
</Card>
<Card title="Payouts" href="/payouts">
- [Send a payout](/payouts/send)
</Card>
</SectionCards>

Each <Card title href> is a card. A link list inside a card becomes its items; any other text is its description, which every preset draws under the title. Paper and Grid show a count only for a card that lists links ("3 articles", "3 pages"); a card with only text reads Read more instead, and shows neither when it has no href. Workbench counts its links the same way.

Props

PropTypeDefaultDescription
titlestring"Documentation" (Margin: "Reference")Heading of the block, where the preset draws one — Plain and Margin do
limitnumber8Most cards shown

In each preset

It's drawn in your preset's home style — or in the layout named by appearance.layout.home while that setting still works. Every preset has a slot for it. Atlas draws its product cards. On a page with the normal frame it sits in the content column; on a layout: wide page it runs across the page.

Example

This site's own, from <SectionCards />:

•
Hero and Search — the hero and the home search box
Was this page helpful? Yes No
Previous
Product
Resources
Company
© 2026 SyntextBuilt with Syntext