> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/creating-content/content-structure/space.md).

# Sections

A section is a part of your site where you work on a set of related pages. Sections let you write content, organize pages, add integrations, and more. Every section belongs to a site, and you can organize related sections into groups.

{% hint style="info" %}
The GitBook API represents sections as `space` objects. This has no impact on API integrations or Git Sync.
{% endhint %}

<figure><img src="/files/NNOaQRDLubwclo6uuRHC" alt="A GitBook screenshot showing a site&#x27;s content tree in the sidebar"><figcaption></figcaption></figure>

### Create a section

1. In your site, click **Add…**.
2. Click **New section**.

Create a section at the top level of your site or inside a group. New sections start as **drafts**: part of your site and editable by your team, but not visible to visitors until you publish them.

Edit a section's name by hovering over the name in the section header.

### Publish a draft section

1. Open the section's **Action menu** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/Zw9q37vPYF03vQIqywTy" alt="The Actions menu icon in GitBook"></picture>.
2. Click **Publish**.

Or publish several drafts at once from the structure editor.

To preview how drafts look on your site, switch the site preview between **Live** and **Live + Drafts**.

### Duplicate a section

1. Open the section's **Action menu** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/Zw9q37vPYF03vQIqywTy" alt="The Actions menu icon in GitBook"></picture>.
2. Click **Duplicate**.

Duplicating a section creates a copy of the source section in the same location (site or group).

{% hint style="warning" %}
Duplicating a section copies the content in the source section. It doesn't copy revisions or version history.
{% endhint %}

### Move or reorder a section

The content tree in the sidebar is read-only. To move a section into or out of a group, or to reorder sections:

1. Open the **structure editor**.
2. Drag the section to its new position.

Changes reflect back in the sidebar — and on your published site — immediately.

### Delete a section

1. Open the section's **Action menu** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/Zw9q37vPYF03vQIqywTy" alt="The Actions menu icon in GitBook"></picture>.
2. Click **Delete**.

{% hint style="warning" %}
**Restore deleted sections from the Trash for up to 7 days.** After that, GitBook deletes them permanently.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook.com/docs/creating-content/content-structure/space.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
