Setting Up the Docs HomeNew
When you have more than one product, /docs/ is the first page most readers see. Under Settings → Display → Docs home you choose its layout and everything on it. With one product, readers go straight to that product’s page and this tab doesn’t apply.
Choose a layout#
| Layout | What readers see |
|---|---|
| Search hub | A big search box first, then a card for each product, numbered start steps, recently updated docs and a help box. |
| Grouped by role | Your product groups from the Products page, each product with every section listed and its doc count. A row of buttons under the search jumps to each group. |
| Classic | The product cards from before 1.0.17. Every site starts here, so nothing changes until you switch. |



The sections below apply to Search hub and Grouped by role. To change the look of the hero at the top, see Docs Home Look.
Heading and search#
- Small label. A short line above the heading, like “Documentation”. Search hub only. Leave it empty to hide it.
- Heading and Intro. Leave the intro empty to hide it.
- Search box text. The placeholder in the search box. {count} becomes the number of public docs, so it stays right as you add docs.
- Results. Group results by product, up to a number per product (3 by default). You can also show product filters above the results, and show “Ask AI about …” under the results when the Ask AI widget is on.
The search is live, like the topbar search, and covers every product. Readers move through results with the arrow keys and open one with Enter. Ctrl K (Cmd K on a Mac) jumps to the search box.

“Try” links#
Short links under the search box that give readers a place to start. Choose what they show:
- Docs I choose. Up to 6 docs. Drag to reorder. Each link’s label is the doc title until you change it.
- Top searches. The words people search for most that found docs. Clicking one runs the search. Search logging must be on (Settings → Setup → Content).
- Popular docs. The same docs as the Popular tab.
- Off.

Product cards#
Each product gets a card with its doc count, its first sections or your homepage links, and a main button. Card order and groups follow the Products page. See Product Cards on the Docs Home for each card’s settings.
Start steps#
Up to 6 numbered steps for new readers, like “Set up bookings” or “Build a form”. Search hub only. Each step has a title, a short text and what it opens: a product, a category or a doc. Drag to reorder.
A step whose page is unpublished or made internal-only hides itself, and shows up in the checks at the bottom of the tab.

Recently updated#
A list of recent changes, in the Search hub layout. Choose one:
- Docs marked New or Updated, newest first, then the latest edits.
- Your latest changelog entries, under a “What’s new” heading. Hidden while there are none.
How many sets the number of items. Internal-only docs are only listed for people who can read them.
Help box#
A “Can’t find it?” box with a heading, a short text and up to two buttons:
- Ask AI button. Shown when the Ask AI widget is on (Settings → Team & advanced → AI).
- Contact button. A label and a link, like your support page. Leave the link empty to hide the button.
The box needs at least one of the two buttons. With neither, it’s hidden.
Group buttons (Grouped by role)#
Short labels for the “jump to” row under the search, one per product group, like “I run a business”. Leave one empty to use the group name.
Checks#
The bottom of the tab lists what to fix before you switch layouts, like a product with no description, a start step that leads nowhere, or Ask AI buttons that are hidden because the widget is off. Click View docs home to see the page.

Fits your site#
The docs home uses your colors, fonts and dark mode from Appearance, and stacks neatly on phones. Every text can be translated with WPML or Polylang. Internal-only products and docs only show to people who can read them.
Set it up with Claude#
With Claude connected, you can ask: “Set up the docs home with start steps and an audience line for each product.” Claude reads and saves every setting on this tab. See Connecting Claude to Your Docs (MCP).
Was this helpful?
Thanks for your feedback!
✓ Feedback received. Thank you!