Links

Content in a space

Table of Contents

The table of contents in a GitBook space
Each space can contain as many pages as you need to write your documentation. All these pages are visible on the left side of your screen in the table of contents.
From the table of contents you can:

Organizing your content

Pages organized in the table of contents under page groups
There are 4 different types of entries for the table of contents.
Initial Page
The initial page is the homepage or the root of your documentation and works as the main node of all the pages of your documentation.
Pages
A page has a title, an optional description, and a content area where you can write and add any kind of content.‌
You can nest pages by dragging and dropping a page below an other in the table of contents.
Theoretically, there is no limit to page nesting. But we advise that you avoid adding more than 3 levels of nesting to avoid overly complex structures that might be overwhelming to navigate.
When you change the title of a page, the page's slug (the part at the very end of the URL, e.g. /hello-world) will automatically update, unless you've already manually set the page's slug.
You can change the title and the slug of a page anytime by clicking on the triple dot icon next to the page title in the table of contents, and then clicking rename.
Page Groups
Page groups are created to bring pages together and for you to create sections of pages dealing with similar subjects.
Groups can only live at the top level of the table of contents. You cannot nest groups inside groups.
You can change the title and the slug of a group page anytime by clicking on the triple dot icon next to the group title in the table of content, and then clicking rename.

Create a new page

If you're in live edit mode, you'll spot the new page link on the left-hand side under the existing pages in your table of contents. If your space is locked for live edits, you'll first need to start a new change request by clicking the edit button near the top right corner of the space.
Adding a new page in a change request
Once a new page is created you will be able to write rich text and rich content using our editor.

Create a page group

If you're in live edit mode, can click the new page button on the left-hand side under the existing pages in your table of contents, and then choose new group.
If you're in live edit mode, can click the new page button on the left-hand side under the existing pages in your table of content, and then choose new link.

Can't see the option to create a new page?

If live edits are disabled for your space, you will need to create a new (or edit an existing) change request. Once you are in a change request, the new page button (which allows you to create pages, page groups and links) will be available.