/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
Components Popular pages

Popular pages

PopularPages lists your most read pages.

1 min read

<PopularPages> lists the pages your readers open most.

Note

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

Used empty

mdx
<PopularPages />

With no content, it lists your most viewed pages of the last 30 days from analytics. When fewer than 5 pages have views, it tops the list up with the first page of each section. Filled this way it shows at most 5 pages.

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
<PopularPages>: the site has no pages to list, so it shows nothing. Give it content or remove it.

With your own content

mdx
<PopularPages title="Most read">
- [Authentication](/authentication)
- [Webhooks](/guides/webhooks)
</PopularPages>

A link list gives the pages.

Props

PropTypeDefaultDescription
titlestring"Popular right now" (Paper), "Popular tasks" (Atlas), "Popular pages" (other presets)Heading of the block
limitnumber5Most pages shown. When the block fills itself it never shows more than 5

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. Paper and Atlas draw their popular list. The other presets draw it as one section card. 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 <PopularPages limit={4} />:

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