Pages
Add pages, groups, external links, and more to your GitBook spaces
Last updated
Add pages, groups, external links, and more to your GitBook spaces
Last updated
A page in GitBook is the place where you add, edit and embed content. Pages always live inside a space, allowing you to group up related content and create different sections for the topics or areas you’re covering.
You can create as many pages as you need in a space. They’re all visible on the left side of your screen in your space’s table of contents.
There are three types of pages you can add:
A page has a title, and optional description, and an 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. Doing this creates a subpage.
Tip: There’s no limit to page nesting, but we’d recommend you avoid more than three levels of nesting to avoid an overly-complex navigation.
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 also change — unless you’ve manually set the page’s slug previously.
You can change the title and the slug of a page at any time by clicking opening the page’s Action menu and choosing Rename.
Page groups make it easy to bring pages together into sections that cover related content.
Page groups can only live at the top level of the table of contents. You cannot nest page groups inside page groups.
To change the title and slug of a page group, click the Action menu icon next to the group title in the table of contents and choose Rename.
External links are simply links to external sites and resources. Adding a link doesn’t create a page in your content. Clicking one in the sidebar will immediately open the link in a new tab.
When in live edit mode or in a change request, you can create a new page by clicking Add new page > New document page at the bottom of your table of contents.
Alternatively, you can hover between pages in the table of contents and click the + icon that appears.
Once you’ve created a new page, you can add content to it using the editor.
Just like creating a new page, you can create a page group by choosing Add new page > New group from the bottom of your table of contents.
To add an external link to your space, click the Add new page button at the bottom of the table of contents, then choose New link. Give the link a title — this will appear in the table of contents — and then add the URL and click Insert.
If live edits are disabled for your space, you’ll need to create or edit a change request. Once you’re in a change request, the New page button (which allows you to create pages, page groups and links) will be available in the table of contents.
Alternatively, you may not have the correct permissions to edit a page.
