8 August: Page icons, docs site improvements, hidden pages and more

We’ve added new icon options for your pages, made a bunch of improvements to docs sites, made hidden pages and MFA available for everyone, and much more

✨ New

  • You can now choose from a set of 3,600 icons to add to your GitBook pages, to help you add more context to your table of contents. It’s added to the picker when you click next to your page title, alongside emojis. Plus, the picker now remembered your more recently used options so you can quickly add them again. For icons on published pages, you can also change the icon style from the Customization menu from five options.

  • We’ve improved your docs site’s home screen, with a new header that shows all the useful information you need about your site and some handy links to edit your content or change your settings.

  • We’ve added a new flow for creating a docs site — you’ll now be guided through naming your site and choosing between an empty site or some sample content, before you choose whether to publish. It’s designed to get your site set up quickly and is great for new users. And just try clicking the icon on the preview to the right for a little easter egg 😉

  • As part of our ongoing UI improvements, this release makes it easier to navigate around GitBook. The sidebar has new buttons and a neater layout to make it easier to select and expand different sections. You’ll also see improvements in the Settings page, and a few other smaller improvements and fixes around the whole app.

  • Last month, we told you we were slowly rolling out multi-factor authentication. Now, we’re pleased to confirm that MFA is available for everyone who wants to use it.

  • Likewise, the option to hide pages from a space is also available to everyone now. Take a look at our previous changelog update to find out more.

➕ Improved

  • GitBook will now remember how you logged in last time, and suggest it next time you need to log in — just in case you forget whether you signed up with GitHub, Google or an email.

  • When you sign up to GitBook, we’ll now ask you what you want to use it for and offer you relevant options based on that choice.

  • We’ve made a number of UX improvements and bug fixes to improve the performance of the files manager. As well as better sorting options and better page switching, you'll also notice that you can click the file preview to open a zoomed version of the file, and click the file to open the actions menu.

🔧 Fixed

  • Fixed an issue that caused the app to crash when a referenced snippet no longer exists.

  • Fixed an issue that meant links to other published content inside a docs site variant had the wrong URL.

  • Fixed a bug that prevented you from deleting a block in some situations.

  • Fixed an issue that meant you could create multiple change requests by clicking quickly on the Edit or New change request buttons.

  • Fixed an issue with share links in docs sites — viewing the share links for a site would crash the app if there were more than 10 links.

  • Fixed a number of visual layouts on mobile, including breadcrumbs, docs site list, insights, and more.

  • Fixed an issue that meant when you opened the revision history for a page, it could break navigation on other side panels, such as comments.

  • Fixed a layout issue in the notifications menu that would push the text too close to a user’s avatar.

  • Fixed an issue that meant resolving conflicts could revert back to their conflicting state.


We’re constantly working on improving the way you and your team work in GitBook, and value your input on features, bugs, and more. Make sure you head to our official GitBook community to join the discussion.

Last updated