Docs
← Back to site

Setting Up the Docs HomeNew

4 min readUpdated November 21, 2026

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 Layout choice at the top of the Docs home tab
The Search hub layout on /docs/
The Grouped by role layout on /docs/

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.

  • 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.

Live search results grouped by product, with the product filters

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.
The "Try" links setting with four docs

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.

The Start steps setting with four steps

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.

The Checks list at the bottom of the Docs home tab

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?

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