Content in a space

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:

Pages organized in the table of contents under page groups
There are 4 different types of entries for the table of contents.
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 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.
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
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.

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.
Last modified 6mo ago