---
title: "Build a docs area"
description: "On Studio, build a help centre or documentation with a docs home, nested doc pages, a sidebar, previous and next links, and docs blocks."
url: "https://www.litetile.io/docs/blog-and-docs/build-docs"
lang: "en"
---

At the end of this guide your site has a docs area: a docs home with doc pages under it, a sidebar that lists them in your order, and previous and next links between them.

Note

Studio. Docs are on the Studio plan. See [Plans and billing](https://www.litetile.io/docs/account-and-billing/plans-and-billing).

## How a docs area is built

A docs area is a **Docs home** with **Doc page** pages under it. The docs home is a full-width page like any other, for example /help. Doc pages sit under it, or under another doc page, up to three levels below the docs home: /help/start/install/linux is as deep as it goes.

Each published doc page shows:

- a sidebar listing the doc pages of its docs area, with the current page marked;
- a breadcrumb of the pages above it;
- the page's title as its main heading, then its content;
- links to the previous and next doc pages;
- an **On this page** list of the page's Heading blocks.

On a phone, the sidebar folds behind a **Menu** button.

A site can hold several docs areas, such as one for customers and one for suppliers. Each has its own sidebar.

## 1\. Create the docs home

1. Open **Pages** and choose **New page**.
2. Under **Type**, choose **Docs home**.
3. Type a **Title**, such as "Help", and check the **Slug**.
4. Choose **Create page**.

Build the docs home like any page, with the blocks (the sections of a page) you like: an introduction, links to the main topics, a contact band.

## 2\. Add doc pages

1. Choose **New page** and pick the **Doc page** type.
2. Under **Parent**, choose the docs home or another doc page. "Only a docs home or a doc page. A doc page sits at most three levels below its docs home."
3. Type the **Title** and choose **Create page**.

If the site has no docs area yet, the dialog says "Create a docs home first" and offers **New docs home**.

## 3\. Write the page

A doc page offers Text, Figure, Section, Spacer and Embed, plus five blocks made for documentation:

3\. Write the page

- Block
- What it is for

- Heading A level 2 or level 3 heading. It appears in On this page, and readers can link straight to it
- Code block Commands or code readers copy, with a Language label and a copy button
- Callout A short remark set apart, with the Tone Note, Tip, Warning or Danger
- Table Two to six columns under a header row, up to 50 rows
- Tabs Two to five tabs, each a label over a text panel, for alternatives such as one per platform

The docs blocks fit posts and ordinary pages too.

## 4\. Set the sidebar label and the links

1. In the editor, click an empty part of the canvas so the right panel shows the page settings.
2. In the **Doc page** section, type a **Sidebar label** if the title is too long for the sidebar. "Leave it empty to use the title."
3. Set **Previous** and **Next**: **Automatic** follows the sidebar order, **None** hides the link, or pick another page of the same docs area.
4. Choose **Save**.

![The editor: doc page section.](https://media.litetile.app/media/6eee3550-99b4-4494-8fc5-d588d1e67e1e/fa8b5b0f-6608-4612-bdfd-f41574b7d0b6.png)

## 5\. Order the sidebar

A new doc page goes last among its siblings. To move it:

1. On the **Pages** screen, open the doc page's row menu. In the editor, use the **Pages** panel.
2. Choose **Move up** or **Move down**. At either end, the button is disabled.

![The Pages screen: move up / Move down on doc rows.](https://media.litetile.app/media/6eee3550-99b4-4494-8fc5-d588d1e67e1e/525b96e4-e1bf-4589-b95c-abc78a59a4b7.png)

To place a page under another parent, choose **Move** in its row menu.

## Publish

Publish doc pages as any page. See [Publish changes](https://www.litetile.io/docs/publishing/publish-changes). Publishing one doc page also refreshes the sidebar and the previous and next links on the other pages of its area, and the dialog says so. A doc page that is not published does not appear in the sidebar of the live site.

Tip

To keep a whole docs area out of search results, turn on **Hide from search engines** on the docs home. It applies to every doc page of the area.
