site-sections.md

icon	description
rectangles-mixed	Add multiple products and sections to your site and create a content hub with tabs to access all your content

Site sections

{% hint style="info" %} This feature is available on the Ultimate site plan. {% endhint %}

Example of a GitBook site with Site Sections

Create a seamless experience for your audience with a site that supports multiple sections, each with its own navigation tree. Perfect for organizing distinct parts of your documentation—whether you're managing separate product versions or catering to both end users and developers with tailored content.

The spaces you link as sections can contain any content, but it is recommended to use sections as semantically different parts of your docs. If the spaces you'd like to link are variations of the same content, consider adding them as content variants instead.

Adding a section to your docs site

From your docs site’s dashboard, click the Settings button, then click Structure. Here you can see all the content of your site.

To add a site section, click the Add section button underneath the table and choose a space to link as a section. The new section is then added to the table and will be available to visitors as a tab at the top of your site.

Add structure to your docs with site sections.

Editing a section

You can change the name and slug of each of your sections by tapping the Edit button in the table row of the section you’d like to edit. This will open a modal. Edit the field(s) you'd like to change, then click the Save button to save. You can also delete the variant by clicking the Delete variant button in the lower left.

{% hint style="info" %} Changing a section’s slug will change its canonical URL. GitBook will create an automatic redirect from the old URL to the new one. You can also manually create redirects. {% endhint %}

Reordering sections

Your site displays sections in the order that they appear in your Site structure table. Sections can be reordered by grabbing the Drag handle and moving it up or down. All the spaces within that section will be moved with it. The changed order will be reflected on your site immediately.

You can also use the keyboard to select and move content: select a section with the space bar, then use the arrow keys to move it up or down. Hit the space bar again to confirm the new position.

Setting a default section

If you have multiple sections in your site, one section will be marked as the default. This section is shown when visitors arrive on your site, and is served from your site’s root URL. Other sections each have a slug that is appended to the root URL.

To set a section as default, click on the Actions menu in the section's table row and then click Set as default.

Remove a section

To remove a section from a site, click the Settings button from your docs site dashboard, then click Structure to find the content you want to remove. Click the Edit button next to the section you want to remove, then click the Delete button in the lower left of the modal. This will remove the section, along with all the variants within it, from the published site. It will not delete the spaces itself, or the content within them.