# GitBook UI

Learn about the different components and UI in GitBook’s editor

GitBook is split into different sections to make it easier to organize and manage the content you create.

### Sidebar

<figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-8d0cbf52059dec4bc14d9ebf482316012f46f3e4%2F10_01_25_ui_sidebar.svg?alt=media" alt="A GitBook screenshot showing the sidebar"><figcaption><p>The GitBook sidebar holds all of your documentation, as well as notifications, the search bar, snippets and more.</p></figcaption></figure>

The sidebar allows you to see and overview of your GitBook organization at a glance. The sidebar contains:

* **Organization switcher**\
  If you’re a part of multiple organizations, you can see and switch between them here. You can also create a new organization from this menu.
* **Notifications**\
  When you’re tagged in a comment or conversation, or when there is important activity in a space you’re working in, you’ll get a [notification](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/collaboration/notifications) to show you what’s new.
* **Ask or search**\
  Powered by [GitBook AI](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/searching-your-content/gitbook-ai), you can ask questions in natural language, or search through the different spaces and content in your organization.
* **Home**\
  The Home page allows you to see everything your team is working on at a glance. View open change requests, discussions and comments, recent page edits and more.
* **Docs sites home**\
  Click this to visit the overview page for all the docs sites you have created in your organization.
* **Integrations**\
  GitBook [integrations](https://github.com/GitbookIO/public-docs/blob/main/content-editor/editor/broken-reference/README.md) supercharge your content, allowing you to embed more into your pages, or add information to your knowledge base from other apps.
* **Docs sites**\
  Toggle this section to view all the [docs sites](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/publishing-documentation/publish-a-docs-site) in your organization right in the sidebar and jump to one with a click.
* **Spaces**\
  The spaces section is where you’ll find the [collections](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/content-structure/collection) and [spaces](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/content-structure/space) you create when adding more content. Head to our [content structure](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/content-structure) section to find out more.
* **Settings**\
  You’ll find [personal settings](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/account-management/account-settings) and [organization settings](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/account-management/organization-settings) at the bottom of the sidebar. Here, you can also toggle light/dark mode, or get help from our support team if needed.
* **Trash**\
  Deleted spaces appear in the trash. You can restore them for up to seven days — after that, they’re permanently deleted.

### Table of contents

<figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-ac352caf3aecea5c5a9f603a58e9c88ed1da9dfa%2F10_01_25_ui_table_of_contents.svg?alt=media" alt="A GitBook screenshot showing the table of contents"><figcaption><p>The table of contents lists all the pages and links in your selected space.</p></figcaption></figure>

By default, the table of contents shows a list of [pages, links, and groups](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/content-structure/page#organizing-your-content) that make up a space. You’ll find it to the right of the sidebar. It’s specific to the space you’re currently viewing.

The table of contents is also where you can view and manage [resuable content](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/reusable-content) and [files](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/blocks/insert-files) for your space.

From the **Pages** tab in the table of contents you can:

* Create new [pages](#pages) and subpages
* Create [page groups](#groups)
* Add [external links](#external-links)
* Access [the Actions menu](#the-actions-menu) <picture><source srcset="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FQ4IsWwmEEi5QM7PSXNsN%2Factions%20-%20dark.svg?alt=media&#x26;token=ebff54f4-9825-4ab0-99bc-633e1c449371" media="(prefers-color-scheme: dark)"><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt=""></picture> for individual pages.

In the **Reusable content** tab, you can:

* View and search through the reusable content in the space
* Create new reusable content
* Drag and drop reusable content onto the page
* Rename and delete reusable content

In the **Files** tab, you can:

* View, search and reorder the files in your space
* Drag and drop more files into your space
* Manage individual files

If you want to give more focus to the content of your page, you can temporarily hide the table of contents by hovering your cursor next to it and clicking the **Hide** button <picture><source srcset="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FgXIVpUPXn7bJ2SWzgFzd%2Fpanel%20left%20-%20dark.svg?alt=media&#x26;token=424e246d-05bd-4d49-a287-bfc6fb38174b" media="(prefers-color-scheme: dark)"><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F0goJ97jfVBvH656kUK0d%2Fpanel%20left.svg?alt=media&#x26;token=cb31d43b-804c-4c4f-b5bb-e71db0d03860" alt="The Hide button icon in GitBook"></picture> that appears. To make it appear again, hover your cursor near the edge of the page and click the **Show** button <picture><source srcset="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FNWbU09fwPj4NJK1clKmm%2Fpanel%20right%20-%20dark.svg?alt=media&#x26;token=35d1e4d0-bc5d-406f-a1e8-c3808acc4d30" media="(prefers-color-scheme: dark)"><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FwOFmEqy96fMvDPjqjAED%2Fpanel%20right.svg?alt=media&#x26;token=2f39279a-cd05-48a3-8985-d07ec08663ba" alt="The Show button icon in GitBook"></picture>.

### Space header

<figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FXm3wJzJapTaBgC8MFIvl%2F03_02_25_space_header.svg?alt=media&#x26;token=106e5536-9ec6-4b0b-aee4-a14f6a6147b6" alt="A GitBook screenshot showing the space header"><figcaption><p>The space header sits at the top of the editor, and offers options that apply to the whole space.</p></figcaption></figure>

The space header contains information about the space you’re currently viewing. It lets you do things like publish and share your space, view the comments and history for the space, configure [GitHub or GitLab sync](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/getting-started/git-sync), and more.

{% hint style="info" %}
The space header is adaptable, and changes depending on the space and mode you’re currently in.

For example, if you’re editing a [change request](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/collaboration/change-requests), you will see options to open the editor, view changes and merge your change request. If you’re viewing a read-only space, you will have the option to open a new change request, but won’t have an editor option.
{% endhint %}

The space header includes:

* **The space emoji or icon**\
  You can choose an emoji or icon for your space, to help you easily identify it in the sidebar.
* **The space name**\
  The name of the space that will appear in the sidebar, and your documentation if and when you choose to publish it.
* **The space’s breadcrumbs**\
  A full, linear list of the collections or docs sites the space lives in.
* **Actions menu** <picture><source srcset="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fpn5vEw7bYFrMPpdyvpSu%2Factions-horizontal%20-%20dark.svg?alt=media&#x26;token=ec39eefe-a391-4fe2-828a-082b79f2847d" media="(prefers-color-scheme: dark)"><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FPnnI41SqLSaKBNwT98fW%2Factions-horizontal.svg?alt=media&#x26;token=99754200-a354-4ffe-931e-aa6322ea7395" alt="The Actions menu icon in GitBook"></picture>\
  Offers a list of actions for your space. Similar to [page actions](#the-actions-menu), the available actions for a space will differ depending on the mode you’re currently in.
* **Editor view**\
  This view is where you can make edits to your content using GitBook’s block-based editor.
* **Changes view**\
  This view [highlights the changes](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/collaboration/change-requests#diff-mode) made within a change request using the diff view. This is ideal for reviewing new content before merging your change request to push the changes live.
* **Preview**\
  This view allows you to quickly see a preview of your content before you merge a change request.
* **Collaborators**\
  The avatar of anyone else who’s currently viewing a page in your space, with colored circles to show their cursor color. Click an avatar to jump to the page they’re currently viewing.
* **Git Sync configuration**\
  The [GitHub and GitLab Sync](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/getting-started/git-sync) configuration for your space.
* **The Share menu**\
  Allows you to publish and share your space. You can also invite others to [collaborate](https://github.com/GitbookIO/public-docs/blob/main/content-editor/editor/broken-reference/README.md) through this menu.
* **Comments**\
  See the [comments and discussions](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/collaboration/comments) you and your team have had about the space content.
* **Broken links**\
  Any [broken links](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/broken-links) that have been found in the current space or change request.
* **Change requests**\
  Create, update, and delete [change requests](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/collaboration/change-requests) in your space.
* **Space history**\
  View [a version history](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/version-control) that includes all the changes made in the space — or in your current change request — over time.
* **The Edit button**\
  If your space is published, or someone has locked[ live edits](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/collaboration/live-edits), the **Edit** button will appear in the space header. It will create a new [change request](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/collaboration/change-requests) to edit content.

### Site header

The site header contains information about the site you’re currently viewing. It lets you do things like view site insights, customize your site, change its settings and preview the site in different modes and screen sizes. You can also configure integrations and manage members’ access.

The site header includes:

* **The site name**\
  The name of the space that will appear in the sidebar, and your documentation if and when you choose to publish it.
* **The site’s breadcrumbs**\
  A link back to the main Docs sites screen.
* **Actions menu** <picture><source srcset="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fpn5vEw7bYFrMPpdyvpSu%2Factions-horizontal%20-%20dark.svg?alt=media&#x26;token=ec39eefe-a391-4fe2-828a-082b79f2847d" media="(prefers-color-scheme: dark)"><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FPnnI41SqLSaKBNwT98fW%2Factions-horizontal.svg?alt=media&#x26;token=99754200-a354-4ffe-931e-aa6322ea7395" alt="The Actions menu icon in GitBook"></picture> Offers a list of actions for your site. You can visit your site or copy its URL quickly from this menu
* **Overview**\
  The site overview shows you essential information about your site including it’s URL, publish status, audience and content, as well as top-level insights.
* **Insights**\
  The [insights panel](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/publishing-documentation/insights) gives you detailed anayltics about your site and how it’s performing.
* **Customization**\
  Here you can [customize your site](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/publishing-documentation/customization) with your own logo, colors, header links, and much more.
* **Settings**\
  Access your [site’s settings](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/publishing-documentation/site-settings) and control the name, audience, content structure and other options.
* **Preview**\
  The preview tab lets you quickly see how your published site will look in light and dark mode across desktop and mobile displays.
* **Integrations**\
  The button opens a modal that lets you install and configure [integrations](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/integrations/install-an-integration) for your site.
* **Member access**\
  View and manage who can access your site in the GitBook app, and what permissions they have.
* **Visit site**\
  Click this to instantly open your published docs site in a new tab. This button only appears when your site is live.

### Content editor

The editor is the main part of your space, where you can write or insert content in GitBook.

In addition to the multiple [content blocks](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/blocks) you can insert, you can also [embed content](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/blocks/embed-a-url) and use certain [integrations](https://github.com/GitbookIO/public-docs/blob/main/resources/broken-reference/README.md).

### Page title and description <a href="#page-title" id="page-title"></a>

At the top of each page you can set a **title**, add an optional **emoji**, and write a **description**. The title you use will appear in the table of contents, and forms your page’s URL slug when published.

Your page description can be a maximum of 200 characters long, and will act as the preview text for your page in search engines.

{% hint style="info" %}
You can change the URL slug for a page by choosing **Page Actions** <picture><source srcset="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FQ4IsWwmEEi5QM7PSXNsN%2Factions%20-%20dark.svg?alt=media&#x26;token=ebff54f4-9825-4ab0-99bc-633e1c449371" media="(prefers-color-scheme: dark)"><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> > **Rename**. Find out more about [Page Actions](#page-options) below.
{% endhint %}

### Page actions menu

The page’s **Actions menu** <picture><source srcset="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FQ4IsWwmEEi5QM7PSXNsN%2Factions%20-%20dark.svg?alt=media&#x26;token=ebff54f4-9825-4ab0-99bc-633e1c449371" media="(prefers-color-scheme: dark)"><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> allows you to do things like duplicate, rename or delete your page.

You can open the **Actions menu** using the <picture><source srcset="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FQ4IsWwmEEi5QM7PSXNsN%2Factions%20-%20dark.svg?alt=media&#x26;token=ebff54f4-9825-4ab0-99bc-633e1c449371" media="(prefers-color-scheme: dark)"><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> icon that appears when hovering over your page in the sidebar, or from the icon next to the page title.

{% hint style="info" %}
The type of actions available will depend on whether you’re in [live editing](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/collaboration/live-edits) mode or a [change request](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/collaboration/change-requests).
{% endhint %}

### Page options

<figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-d6bfc3fa2aa459b0a03bfb695cf7305e0673df76%2F10_01_25_ui_page_options.svg?alt=media" alt="A GitBook screenshot showing the Page options side panel"><figcaption><p>The <strong>Page options</strong> side panel offers customization options for your documentation and navigation.</p></figcaption></figure>

With page options, you cam customize your documentation layout and navigation. You can only access page options if you’re in an editing mode.

You can open the **Page options** side panel by opening the page’s **Action menu** <picture><source srcset="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FQ4IsWwmEEi5QM7PSXNsN%2Factions%20-%20dark.svg?alt=media&#x26;token=ebff54f4-9825-4ab0-99bc-633e1c449371" media="(prefers-color-scheme: dark)"><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> and choosing **Options**, or by hovering over the main title of the page and clicking **Page options** when it appears.

{% hint style="info" %}
Certain changes, such as disabling the table of content, only apply to published documentation and may not be visible in the editor.
{% endhint %}

### Page outline

<figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-36d1119a8ae3c07c14911868832ea77f5a138255%2F10_01_25_ui_page_outline.svg?alt=media" alt="A GitBook screenshot showing the page outline"><figcaption><p>The page outline shows H1 and H2 headings, allowing you to quickly jump to a specific section on an individual page.</p></figcaption></figure>

The **page outline** sits on the right-hand side of the editor, and makes it easy to jump directly to the section of the page you’re looking for.

Any [headings](https://gitbook-v2-nuope4h2g-gitbook.vercel.app/url/gitbook.com/docs/creating-content/blocks/heading) you add to the page will appear in the page outline listed here.

The page outline will appear in your published site, too. You can toggle it on or off in the [**Page options**](#page-options) side panel.

{% hint style="info" %}
If you can’t see the right-hand column of the app, it may be because your browser window is less than 1430 pixels wide. Your browser window needs to be at least 1430 pixels wide to see and use the page outline.
{% endhint %}
