Docs
← Back to site

The Docs Homepage & Category Cards

2 min readUpdated November 21, 2026

The /docs/ homepage and each product’s landing page are generated automatically from your products, categories, and docs. There’s nothing to build by hand, though a few settings let you shape what shows up.

The docs index (multi-product mode)#

At /docs/, readers see:

  • A Browse by product section, with a card for each product. Each card shows the product’s image (if you’ve set one), name, and description.
  • A Popular answers section below it, if enabled (see below).
The docs homepage with product cards grouped under WordPress Plugins and Tools and Apps.

If you’re running in single-product mode, or you only have one product with published docs, this index is skipped entirely. Readers go straight to that product’s page instead.

Since 1.0.17 you choose how this page looks under Settings → Display → Docs home: Search hub (a big search, product cards, start steps, recent docs and a help box), Grouped by role (your product groups with every section listed) or Classic (the product cards described here). Classic is the default, so nothing changes until you pick another layout. See Setting Up the Docs Home and Docs Home Look.

The product page#

At /docs/{product}/, readers see:

  • The product’s name and description as a heading (hidden in single-product mode, since it would be redundant).
  • A Browse by category section: a card for each category that has published docs in this product, showing the category’s icon (if set), name, description, and doc count. Clicking a card goes to that category’s listing at /docs/{product}/{category}/.
  • A Popular docs section scoped to this product, if enabled.
A product page with the category cards and the docs sidebar.

Category cards follow the order set on the Navigation page, so if you’ve customized your nav order there, the cards reflect it. See Auto-Generated Navigation vs. Manual Override for details.

Both the docs index and each product page can show a “Popular” section. It’s on by default, and can be configured under WP Super Docs → Settings → Display → Popular:

  • Manual mode: you choose which docs to feature.
  • Post Views Counter mode: if the free Post Views Counter plugin is active, the most-viewed docs are shown automatically instead.

You can customize the section’s heading and intro text, and how many docs it shows (1 to 24).

Using docs as your homepage#

If your entire site is documentation, you can have /docs/ take over your site’s actual homepage (the front page visitors land on at your root domain). Turn this on under Settings → Setup → General with Use as the site homepage. When enabled, visiting your root URL shows the same index or product page described above, instead of your normal WordPress homepage.

The Use as the site homepage setting.

Was this helpful?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only