Customize your space
Customizing your space lets you control the branding, presentation and extra features of your space's public content.
If the space you are customizing is within a collection, you'll see this option:
When this setting is enabled, the space will automatically inherit any changes made to the customization settings for the parent collection. This is useful if you want to control multiple spaces' customizations in one place, and removes the need to make the same change multiple times across spaces.
You will see an internal icon and title when logged into the GitBook app. Those are usually set when you first create a space and include a random emoji. By navigating to the title & icon you can override those settings and choose the different external appearance, that your visitors will see when they access your published content.
You can upload your own square image as your space icon or use a long list of emojis provided.
You can replace both the space's title and icon with a custom logo so that your documentation better reflects your own branding.
The icon allows you to upload a small 132px square image and which will be displayed alongside your space title while the custom logo allows you to upload a larger image and gives you full control over the image and space title.
We offer a number of header options for our theme:
Matching In light theme mode, the header will have a light background. In dark theme mode, the header will have a dark background.
Bold The selected primary color will be used for the header background.
Contrast In light theme mode, the header will have a dark background. In dark theme mode, the header will have a light background.
You can add links to the header section of your documentation. For each link, you will need to set a URL and a text label. You could use header links to link to important parts of your documentation, or perhaps to link back to your main website.
You can also create a navigation menu by adding links and sub-links which will show as drop-downs for each item.
Pagination allows you to control whether the buttons Previous or Next appear at the bottom of your page
Footer allows you to upload an image, copyright text and add column titles with links.
You can upload a custom social preview image for your space. This will set the space's og:image to be your uploaded image, and it'll show when the space's link is shared to any platform or product that supports OpenGraph images.
You can select from a list of languages to localize the user interface of your published content. This will apply translations to the non-custom areas of the interface.
This setting will not auto-translate your actual content, but can help with matching the user interface to the language that you are writing in.
Is there a language we don't yet offer that you would like to see included in this list? Let us know!
Enabling Lens allows visitors to your published documentation to ask questions and receive a semantic answer based on your content.
You can find out more about Lens.
You can choose whether or not you'd like visitors to your published content to be able to download the content as a PDF file.
You can find out more about the PDF export feature.
Choose whether or not visitors to your published content can leave a rating on each page to let you know how they feel about it.
You can review the results of this survey if you click on insights in the space sub-navigation.
Provide a privacy policy to help visitors understand cookie tracking. Otherwise, the GitBook privacy policy will be used.
Enable Intercom or Google Analytics integrations on your published content.
Looking for more integrations? Read about our integrations including Segment, Plausible or Fathom.
Last updated
Was this helpful?