---
title: "Docs homepage"
url: "/help/buuk/docs-homepage"
updated: "2026-11-13T18:25:37.076Z"
---
# Docs homepage

The docs homepage is the first page readers land on at `/help/your-slug`. It carries your brand, a headline, and a quick way into the content customers search for most.

![A docs homepage with a headline, quickstart links, feature cards, and collection tabs in the header.](/api/media/assets/eb0c1118-404f-461f-90bf-6b062a908c36)

## The homepage fields

Open **Customise** and find the **Docs homepage** section. It has a headline and a subheadline. The content model behind the page also holds up to three quickstart links and up to three value props, which you can derive from your articles or write yourself.

If you leave the headline empty, the page falls back to your workspace title. Write your own headline when you want a task-first greeting, such as “How can we help with your billing?” — the placeholder in the field is the same pattern.

The rest of the page builds itself from what you have published: sections become topic cards, and a trending row highlights popular pages. You can also pin specific articles with the **Feature on homepage** toggle in an article's page settings. Featured pages appear in the Featured section of the home page.

## Deriving copy from your articles or writing your own

Derive it when your docs already say what customers need: point the quickstart links at your Quickstart, first-setup, and troubleshooting pages, and let the value props restate the one-line description you already wrote.

Write your own when the homepage should carry a message the docs do not. Keep the subheadline to one or two sentences. The layout stays templated, so the page does not drift per workspace.

## Picking the docs layout

The **Layout** section in **Customise** gives three arrangements, each with a thumbnail preview:

- **Sidebar **— classic docs: topics on the left, content on the right.
- **Mixed **— sidebar plus a homepage of topic cards.
- **Cards **— a full-width card grid on home, with no sidebar until an article opens.

Articles always keep a sidebar. Choose Cards when visitors should browse topics first; choose Mixed for a homepage of cards plus a steady sidebar on every other page.

The preview pane shows your draft live as you edit. Switch between light and dark and between desktop and mobile before you save. Use **View site** to check the published page, then **Save changes**.

## Link previews

In the **Brand** section, the **Site image** is the preview image when links to your help center are shared on Slack, X, and LinkedIn.

For individual pages, images inside the article and a cover image from page settings become the visuals readers associate with that topic. Use the same treatment — a consistent ratio and framing — so link cards look intentional wherever they land.

> [!TIP]
> Write the headline for who is arriving, not what you shipped. Readers skim, decide in a second, and search.

## Related

- [**Branding**](./branding-and-custom-domain) — logo, brand color, and site image.
- [**Header links and navigation**](./header-links-and-navigation) — the rest of the chrome readers navigate by.
- [**Publish your help center**](./publish-your-help-center) — what goes live, and when.
- [**Docs vs FAQ vs Guides vs API**](./docs-collections) — which tabs your homepage shows.