Your docs homepage is the first page readers see at yoursite.com/docs/. Build it with the PinkDocs landing blocks so readers can search straight away and browse every category from one page.
📷 Image placeholder: a finished PinkDocs docs homepage with a search hero, guide cards and category list.
Choose the blocks for your homepage
| Block | What it adds | Best for |
|---|---|---|
| Hero section with search | A large heading, a short description and a search box with quick links | Most help centres. Readers can search immediately. |
| Hero section | A heading, a description and one button | Product docs that start with a single Get Started guide. |
| Hero with image | A heading, a button and a screenshot beside the text | Showing off your product on the docs homepage. |
| Image cards | Visual cards linking to key guides, two per row | Highlighting your most important guides. |
| Icon cards | Small cards with an icon, title and link | Feature overviews and quick links. |
| Category articles | Every category with its articles, updated automatically | Letting readers browse everything. |
| Changelog | Your latest releases | Showing what's new in your product. |
Build the homepage
Open the homepage for editing
Open the page or template that controls your docs homepage in the block editor.
Add a hero block
Click the + inserter, search for PinkDocs and add Hero section with search. Enter a heading, such as How can we help?, and a one-sentence description.
📷 Image placeholder: the Hero section with search block selected in the editor.
Highlight your key guides
Add an Image cards block below the hero. Add one card for each of your most important guides and set each card's link.
List your categories
Add a Category articles block. Set Articles per category to the number of articles you want to show under each category.
📷 Image placeholder: the Category articles block settings in the editor sidebar.
Show what's new (optional)
Add a Changelog block and set how many releases to show.
Save and preview
Click Save, then view your docs homepage to check the layout on desktop and mobile.
Common questions
Yes. Each knowledge base can have its own homepage built from the same blocks.
Categories only appear once they contain at least one published doc.