We are excited to announce that we're putting the final touches on a major new release of GitBook, and we cannot wait to show you what we're building!
Here's a sneak-peak of what's coming:
A completely renewed UX, including a new navigation and universal search
A new way of organising spaces and permissions, called collections
New powerful tables (with support for data and formulas)
Support for real-time collaboration
Improved async collaboration with new change request section
Ability to create and reuse templates
Support for Swagger (OpenAPI)
Syntax highlighting for many more programming languages
Reviewed permissions management, with invite by email and new roles (commenter / reviewer / creator)
support for SSO with email domain of choice
Multiple SSO SAML providers within the same account
Support for visitor authentication
A new and improved GitHub sync
And last but not least, GitBook will be available in dark mode! 😎
If you have any feedback, don't hesitate to contact us at [email protected]
Added support for authenticated users through JWT token (currently in beta)
Multilingual support is now available with which you can set a default language to your space, and to set "release" specific ones as well. It translates the public-facing UI so you can have a fully translated experience for your readers.
We have included the following languages so far:
Feel free to suggest any other language translations and post it here.
We have now released the PDF export as a beta feature in the business plan for you to:
export your entire space
export a single page
export a subset of pages
You can as well chose if you like to allow readers to download a PDF copy of your content.
Check out our docs for more information!
We launched a new version of GitBook! 🚀
We re-designed GitBook by replacing the edit button with a simple and instant editor. Once on a page, you can just start typing!
You now have a better overview of drafts whether they are merged or archived as well as on activities. The activities being moved to the main panel, now have their own section and give you a better and more granular understanding of changes made to your content.
Some improvements for Drag&Drop for the table of content have been released with this new version as well.
Documentation on this topic will be released soon.
You can contact us at [email protected], we'd be happy to hear about your feedback! 🙂
You can now try out GitBook for free with a 14-day trial. An opportunity to try out all GitBook features, onboard your team and start editing content.
Single users can now create up to 10 spaces.
👨💻 Improve and precise error messages for issues about GitHub sync and migration
🔗 Hide toggle and link for shareable links to non-admins in "share" tab
Fix bug preventing from changing the hint's type when using the controls button
Fix import bug when import missing relative assets
🚀 Improve of performances concerning auth to improve initial load time
Fix scroll in drafts in latest chrome version
Fix regression about phone verification
Fix issue preventing from correctly update changes about logo and emoji
Fix active tabs not displaying as expected in new logo picker
Fix issue with asset's name in GDPR export
Fix regression about alignment of diversity popover in emoji picker
🎨 Space differentiation using emojis and better colors: create a new space, choose between an emoji or a logo as an avatar and pick a color to visually differentiate a space from another! You can read more about it in our blogpost 👉 here.
🚧 Improvement of performances in conflict blocks
🚀 Improvement of performances concerning time to interactive
⏏ You can now exit a tab easily: you can exit a tab when two paragraph are empty and by pressing
Fix issue showing wrong avatar on merge conflict
Fix inline images that couldn't be converted to block in lists
Fix import of markdown files
🚀 Performances improvement about the loading of the dashboard: you can now access your spaces in a flash
🚀 Improve perfomances impacting writing
🔢 Allow old and new App IDs for intercom integration
Fix an issue about Microsoft Edge
Fix some design
🚀 Performance improvements on Table of Contents
Fix sidebar being closed when clicking on it and it's size on mobile
Fix logging error for embeds
Fix a little regression about scroll in the mini table of contents. You can now easily scroll through your content
Fix for inline menu when typing Chineese or Korean
🚀 Performance improvement during edition
Fix background of full logo when not using the header. The full logo background is now transparent
Fix some errors with Slack integration and improve reliability. They're shouldn't be more messages from Slack saying it took too long to respond
Fix most error message when exporting GDPR content
⌨ We added a keyboard shortcut to close search panel: press "ESCAPE" to close it. You can check the list of all our shortcuts here!
🥳 You can now change emojis already existing in your documentation fastly: double click on an emoji to open the emoji picker and change it to another one!
🚀 We also worked on some performances improvements:
Open the emoji picker faster than ever!
Performances improvements on long documents
We hear you loud and clear and investigate and fix a bug dealing with some tabs that couldn't be selected.
⬇ Import of HTML contents: You can now import HTML, Website, Markdown and DOCX
contents to GitBook!
Drop your file... 🖱
... or import you content simply adding an url 🤗
🔍 Unified search: Find what you need across all the spaces of your organization with the multi-space search
💳 Upgrade dialogs redesign: Have a better understanding of what you can have access to when upgrading to start-up or business plans!
📧 Stay up to date with email notifications! You can now be notified by email when a new comment has been created on any of your pages or when there is a new reply in a thread or an activity you participated in!
Fix "Forgot password link"
Fix non encoded XML characters (&, <, >, ', ") that can happen in the sitemap for the title/description.
🖼 Header for spaces is now optional! With or without header is for you to choose: new spaces will no longer have a header in order to let you focus on what you're writing in GitBook! No worries, you can still add one in your customization settings.
A sitemap is generated for each space to improve SEO: All of a space's pages can be now indexed with Google in one shot!
Fix small design issues
Fix a regression when trying to access directly an activity/comment URL
Fix redirect to a specific space after SSO (Single Sign-On) login. This fix impacts businesses with advanced requirements
Fix toaster when having an error during save
Use www.gitbook.com for SAML (Security Assertion Markup Language) instead of app.gitbook.com
Fix search insights
Fix upgrade label that was displayed for flagged orgs
Fix card update popup
Fix disable of full-logo when org is not on the business plan
Fix crash when uploading file too large
Fix crash during setup of custom domain
Fix error when clicking checkbox on themes
Fix redirect when accessing a draft on the public url
Fix error when updating primary color
Fix error with edition of page-refs
🏡 Redesign of our home page and the dashboard: it was time for a spring clean and a new design sprouted in the process. With this major update, we kept in mind the general experience. Let us know what you think of it!
✈ Better onboarding: We've redesign the way to start new projects: creating new organizations and projects is faster and smoother
⚙ Settings at fingertips: You can now easily access and change you space settings: domains, visibility, themes and many more!
🎨 New customization settings: Customize your space is as easy as pie! You can choose a header for your space to match your custom branding or choose among 7 new fonts
Previously each project and the dashboard lived on separate domains, so switching between them required a full app reload. Now, switching between spaces and teams is instant. You won’t stare at your screen for too long anymore!
Access to important information is now easier, directly from the footer: support, feature requests, documentation or keyboard shortcuts and more.
Fixed cursor not moving to previous paragraph when at the start of a line
Fixed the document outline, and other design issues on Firefox
Fixed a bug with billing when entering an invalid card
🦊 Firefox users should now be able to edit normally since Firefox 65. See the complete update on our blog post
🐦 Twitter now generates cards when you share your space
Fixed visual issues with save button, including loading animation
Fixed visual issues when drag-and-dropping paragraphs
Fixed an bug when copying content on Edge
The GitHub export now properly escapes characters inside HTML
Fixed a visual bug with the API Method select menu.
Improved compatibility with older browsers that do no not support internationalization features.
🌍Changed our service infrastructure to resolve issues accessing GitBook from some regions of Eastern Europe.
🛠Improved to the editor in various ways which should reduce random crashes when editing.
⛑Fixed a bug that would erase an editing session backup before it could be restored.
🎯Improved page loading time by optimizing our icons rendering.
🐙Fixed a bug that would trigger a GitHub synchronization from GitBook to GitHub after deleting a branch or tag on the repository.
Fixed a bug with our service status banner which was returning an error page when accessing your dashboard.
Links in comments are now highlighted, and they will no longer overflow from the comment box.
Fixed undesired scrollbar appearing in tables containing emojis.
🐌Fixed an issue in previous release that was making editing impossibly slow.
Add randomized colors for user avatars without picture
Fixed display of space badge when the space has no logo
Fixed join button on the invite page
ALT+/ keyboard shortcut to open search
✅ Fixed toggling checkbox items in lists
#⃣ Fixed pasting Markdown from a code editor
↪ Improved drafts and controls when viewing merged drafts
GitHub-sync fixes and improvements
You can now exit tabs with
Annual and Business Plans are now available in self-service
Invoices are now simpler (less "noise" from pro-rata changes)
💬 Writers can now comment drafts and content! The activity panel is now filled with events such as comments, edits, draft creation and merge. Read our announcement blog post.
🎨 You can now use full-sized logos (such as logotypes) for your spaces.
Changes in the Table of Contents have been redesigned and no longer requires all page and groups to be expanded. This should greatly improve the readability on larger spaces.
Increased size limits for uploaded files and image from 10MB to 25MB.
Fixed a bug introduced in the previous release, where conflicts indicator would no longer be displayed near page titles in the Table of Contents.
description meta tag in page's HTML.
Fixed a bug that prevented legacy organization with a name of less than 3 characters from migrating to the new GitBook.
Fixed a bug that would add extra invisible characters or remove newlines when copying content from GitBook, which was particularly bothersome for code snippets.
Fixed a bug that would make avatars on spaces appear gigantic to visitors using Safari or iOS.
Fixed a bug preventing images and links from being deleted inside table cells.
Fixed crash when visiting a page including a file block and the file that was deleted.
Fixed a bug that would fail to export larger spaces or organizations data.
Improved the dynamic display of dates to not update every second like a countdown.
⚠️Only evergreen browsers are now supported (the latest versions of Chrome, Firefox, Edge and Safari). This will reduces the amount of assets to download to use GitBook and will improve overall performances. Internet Explorer in particular is no longer supported, it represented less than 4 visitors out of 10,000.
Fixed hovering menu in edition being closed when selecting large section of text (like a link)
Fixed error message when changing the email to an email already used by another user
It is no longer possible to mistakenly setup a custom domain that ends with
Fixed redirection and broken app when opening a page containing the name of the space in its URL.
Fixed error when sorting by columns in Search insights
Fixed sign-out button in the phone verification screen
Improved the message when conflicts have been resolved on a page
Improved the page output for empty Markdown files when using the GitHub integration.
Content caches are cleared in more scenarios (content update, space renaming, etc.). Visitors should now load an always up-to-date version of the page.
Added an automatic DNS check and a manual DNS check during setup of custom domain
Fixed GitHub sync generating large diffs when using page groups. This will make for a better conflict resolution during draft merging.
Fixed design of the search bar on Firefox
Fixed loss of spaces that would happen after signing-in with legacy credentials
Fixed tabs being deleted when deleting a single image or file inside it
Fixed redirect after sign-in when a visitor follows a draft URL
Fixed a bug that prevented from loading older revisions in the activity history panel.
Improved error handling for avatar uploads
Fixed a crash when a non-member follows a sign-in link for a space
Fixed order of drafts in Safari
Limited the length of organization names to 65 characters
Fixed billing subscription not being cancelled when switching an organization to a non-profit plan
Fixed design of spaces logos
🎨We overhauled the spaces interface to unify and streamline the navigation across GitBook, notably between spaces. We also reworked the editing interface to be light and efficient. The blue Controls Bar is gone, replaced by a Controls Center panel on the left.
The blue Controls Bar for logged-in users is gone, which means more vertical space available when editing your content.
Improved application reactivity and stability thanks to a refactor of the UI components and styling strategy. Loading time should now be faster and UI should no longer flicker.
You can now quickly switch between your organization and spaces from the Space's Control Center.
Changed wording for drafts and revisioning: "Publish" is now "Merge", and the "Published" version is now called "Current".
Customization of a space's color no longer requires a page reload to be visible.
Space headers have been redesigned to have better vertical alignments, to adapt to title size, and to never hide the search bar on small screens.
Organization logos and user pictures are now consistently circular, to be distinct from space logos which are square.
Prevent empty line from being inserted when writing an image caption and hitting Return.
Fixed an issue that prevented to insert a link in a list and press Return.
Fixed preview of images imported from GitHub in the assets manager.
Fixed a bug during conflict resolution that would sometimes crash the page when displaying avatars near conflicting changes.
Prevented the creation of page with duplicate paths that could occur after publishing a draft.
Organization owners can now be added to teams like normal members, even though they always have access to all spaces.
You can now define a default role for members joining your organization using Single Sign On.
SSO login on a space no longer redirects to the organization's dashboard, but to the space as expected.
🇷🇺 Users in Russia should no longer have issues loading images and other documents on GitBook.
Improved error message during GitHub synchronization to be more specific and point to a faulty page when possible.
Removed unused bio from user profiles.
Fixed a bug that prevented from using the search bar after being going through a page redirection.
Session is now correctly cleared when you delete your account.
🔐 Improve session cookies invalidation when an account update occurs
mailto: links for external pages
🛠 Improved the speed of GitHub sync export
🐞 Fixed a bug preventing to create a space when uploading a custom logo with slow networks
🐞 Fixed transferring the associated custom domain when transferring a space to another owner
🐞 Fixed rendering emojis
🐞 Fixed a bug preventing to publish when the version includes external links
↪️Changing a space's URL now creates a permanent redirection to the new URL.
🎉 New feature: Add automatic redirection when a space URL is modified
🛠 Add stricter limitation to spaces name length
🐞 Fixed a bug where page insights were not correctly displayed
🐞 Fixed disabling the "Edit this page" button when user doesn't have the actual permissions to edit
🐞 Fixed an error preventing embeds URL with no protocol to be correctly rendered
🐞 Fixed a bug preventing to upgrade the subscription in some cases
🐞 Additional fix for migration from legacy.gitbook.com in some cases
🐞 Fixed a bug preventing migration from legacy.gitbook.com in some cases
🐞 Fixed authentication issues when using Google or GitHub login
🐞 Fixed a bug preventing to save when the current revision includes page groups
🛠 Prevent serving invalid content for a deleted space
🛠 Prevent flashes when accessing a space that was switched from private to public
🐞 Fixed a bug preventing the migration to run correctly for some orgs after pricing enforcement
🐞 Fixed a bug preventing users to save their settings and to login/sign up using Google or GitHub
🐞 Correctly trigger a GH sync export when assets only were modified in the published revision
🧾 Pricing enforcement: apply strict usage limitations when subscriptions limits are reached
🧾 VAT was added to invoices
🐞 Display an error message when uploading a profile avatar fails
🐞 Fixed correctly deleting assets in published revision when merging a draft
🎉 New feature: Allow transferring ownership of a space across organizations and single users
🐞 Prevent crashing at initial GitHub sync when repo doesn't have a README.md file
🐞 Fixed 404 error after creating the first personal space during onboarding
🛠 Speed up display of images in Assets Manager
🔎 Fixed a bug during computation of search results leading to missing results when the published revision contains multiple releases
🔎 Fixed a bug that would navigate to the main version of the documentation when opening the search bar
🛠 Improve redirection to login and check of user permissions when accessing a private space
🐞 Fixed some display glitches on Safari
🐯 List our jobs positions using WelcomeToTheJungle
🕵️♀️ Improve error message when GitHub token has expired
🔎 Redesign of search bar and search results
🐞 Fixed Google Translate crashing the app
🐞 Fixed displaying an error message when saving a draft fails
🛠 Fixed expired SAML certificate for SSO login
🐞 Fixed broken login for new SSO users
🐞 Fixed a crash when saving changes that requires an automatic merge with existing changes
🐞 Fixed some crashes when editing API methods
📄 Custom ID for headings are serialized as html when using GitHub sync
📄 Added option to enable/disable page ratings
🐞 Fixed a bug preventing single users to set a custom domain on their spaces
🛠 Improved page loading time
🐞 Fixed migration for legacy organization
🐞 Fixed error leading to incorrect/duplicate billing data (users impacted have been fixed)
🐞 Fixed sign-out link during the phone verification process
🐞 Fixed crash when dragging some kinds of images into the assets manager
🖨 Improved the style when printing the page with
🎬Greatly improved the quality of embeds (videos, sheets).
Resolved issues with size and position of embedded content.
Content served on non-secure protocol (HTTP) are no longer embedded.
Embedding SVG images is now possible
The embedding process is now visible thanks to a loading indicator
🐞Fixed failures of the GitHub import when page titles or descriptions were too long.
🐞Fixed selection issues when double or triple-clicking to select.
🐞Fixed insertion of links without specifying a protocol (like
🐞Fixed a bug when creating a team from a space's settings.
🐞Fixed a bug that would crash the app when resolving conflicts and deleting a block using Backspace.
🔓Fixed a bug that could reveal to the user the password he/she entered during sign-up and sign-in. The risk for people affected by this bug was that someone peeking at their screen during sign-up or sign-in could see the password that was entered. All passwords are still encrypted and then hashed by GitBook.
Fixed a bug with the GitBook trademark that would crash the page for anyone visiting content made with GitBook, without being logged in.
👤It is now possible to create spaces under your personal account! You do not have to create an Organization for these spaces, but you won't be able to invite people to collaborate on them as long as they are under your personal account.
Fixed PHP syntax highlighting.
⚠️Errors when saving a draft are now properly displayed. In the past, it would just do nothing, so you could be misdirected as to whether your changes were saved.
🦋Fixed syntax highlighting in code blocks that was no longer visible for most languages.
🐞Fixed alert banners appearing the mobile menu and the space's settings menu.
🐞Fixed an error that would prevent saving your changes after canceling a conflict resolution.
🐞Fixed a bug that would make formatting (such as bold and italic) very hard to escape when using Markdown syntax.
🐞Fixed crashes when hitting Enter inside a content tab item's title.
🦊Added a warning to our dear Firefox users who are trying to edit content on GitBook. Read our blog post about it.
⛔️Added a warning when you are above the usage limits granted by your current plan.
🐞Fixed a bug when exporting to GitHub some lists inside tables
🐞Fixed a bug that would remove your existing membership to organizations when you joined a new organization using Single-Sign-On.
You can now expand a page and its children in the general Table of Content without navigating to the page.
Links to custom domains that are no longer used will now respond with a 404 Not Found error.
A series of various fixes for bugs introduced in the previous release, including private spaces returning a 404 Not Found error instead of redirecting to login.
Here's a big one:
🔗You can now generate a shareable links for your private spaces. Share this secret link to people you want to be able to read your private content.
👨🎨New design for the table of contents in the sidebar! It's prettier, smoother, and easier to edit than ever.
🛎The GitHub synchronization is now correctly triggered if you updated nothing but your
🗝Making a space private now correctly clear any trace of it from our servers cache, ensuring the content was public can no longer be served publicly. Before, it would take some time before cached content would stop being served.
🦆You can now migrate from the legacy GitBook even if your repository had another branch than
master as default branch.
🐞Fixed a bug that prevented reconfiguring which branches are synchronized with GitHub.
🐞Fixed missing borders for tables in Firefox.
🐞Fixed GitHub export of tables containing lists. They are now exported as HTML to be Markdown compliant.
🤭Fixed drag and drop of pages, that was no longer working since the last release.
🥂You can now resolve change conflicts inside GitBook! We even wrote an article for you.
🛠We searched and destroyed a bug that prevented a lot of writers to publish their drafts.
🖼Sharing a space on the social media now shows a thumbnail even if the space has no logo.
👥If you are invited to an organization, you won't have to step through our phone verification protective process.
✨We have greatly improved copying and pasting around tables.
💳Fixed an error that would not migrate an organizations' subscription to the new version.
💅Fixed a few design glitches: profile menu on mobile and overlapping "Edit on GitHub" button, among other things.
🛠Fixed a few issues: an error with the right table of content, invalid selection when inserting a new list and the dashboard space popover, among other things.
✉️You can now insert
🔎The option to make your space unlisted is now a sub-option of public spaces.
🛠Fixed an issue that prevented some user accounts to be deleted.
☎️We have restored the Sign Out button in the phone verification page, so that you're not locked into an unconfirmed account.
📂We have reorganized the space settings in more logical sections. Feels good!
🎨We made a new and shiny color picker for your space, so you can choose that ONE color among 16 millions.
🖼We also redesigned the space logo uploader, so you can drop that
⚠️The GitHub sync errors in your spaces are now more detailed. This should help you understand better what's going wrong.
⏰We delayed the end of the beta to 15 of September, to give you some more rest.
💬Fixed a permission error that hindered the Slack integration
🛠You can now properly examine the details of your SSO configuration when you've enabled it.
💵Some invoices could not be generated when using coupons. This is fixed.
🏎We optimized the dashboard for people with legacy organization to migrate.
🛠Fixed a bug that prevented exporting tables to GitHub.
🛠Fixed a bug when importing links inside links from Markdown.
💖Tables received a lot of deserved love! They were arguably terrible to edit. Now editing them should be really smoother... and prettier!
🎛Lists styles can now be toggled from their controls.
ℹ️You can now change hint styles by clicking their icon directly. This should save you some precious time!
🌳Can't choose which GitHub branches to sync? We now offer an option to sync them all, no questions asked!
🔗Revamped the link insertion with a cleaner and easier to use design
🖼 Images and files can be reused (and deleted) with the assets manager
💬Intercom Integration is now live !
#️⃣Fixed an issue with exporting
file blocks to GitHub
Greatly improved inline insertion menu (for inline math & image)
Allow (multiple) lists and paragraphs in table cells
🔢Math (TeX) -
🌄Inline images -
🔗Redesign page links (design and editing UX)
📝Fix the "Edit this page" button from the right column
⛹️♀️Fix the "Teams" page when accessed from a space
🎲Fix the restore popup appearing sometimes for no reason
👾Fix a design glitch in the onboarding preview
✂️Fix pasted code formatting
📝Draft by default workflow (also lays ground for conflict resolution UI)
🐛Fix grey background when pasting code into other apps (e.g: GMail)
💳Improve billing UI
🇪🇺GDPR stuff (data export, ...)
📦View archived drafts (closed or merged)
#️⃣Allow pasting markdown into editor
⤴️Add redirects for old
#️⃣Allow editing header IDs (to override auto-generated IDs)
🎨New hint design (warning/info/...)
🔄GitHub sync: export title/description even for pages with no content
🔐Allow org admins to transfer ownership to another user
🎨Redesign images, allow aligning left or centering
🎨Refresh embeds design
🎨Refresh page template designs
🚀Improve editor perfs
🎆 Support inline images (mixed with text)
🚀 Faster pre-rendered pages (cached by CDN)
🚀 Reduce latency of initial page load / connection by optimizing DNS
🐛 Fix anchor links with non-latin characters
✏️ Major improvements to editing controls & command palette
Fixed an error when selecting or deleting embeds
Fixed an error when pressing Enter after having selected images.
A bunch of internal changes, so... nothing visible from your end 😉
We are encountering jobs and requests timeouts for some large content. We have put in place a few measures to mitigate these timeouts until we find a fix.
Emojis (and other unicode characters) are now correctly parsed in their escaped HTML form.
Fixed no longer working syntax highlighting 🤭
🚀 Major update to our internal WYSIWYG engine, which should improve editing stability and performance.
Visiting a revoked invite link now properly inform that the invite was indeed revoked.
Fixed error with import of some Markdown tables
Fixed generated Open Graph meta tags (
🚫 Adjusted our spam protection system and added phone verification instead of blocking users detected as malicious.
Fixed errors coming from missing logos that prevented new project creation.
Fixed a bug that prevented an organization owners from adding himself/herself to a team.
Fixed a bug that prevented editing space header links.
Fixed a few UI errors that sneaked in the Billing settings section.
Further improved books migration stability 🛠
Fixed a bug when filling credit card infos.
Improved stability of the books migration process.
The new GitBook is released publicly as version 1.0.0 🚀🎉
Before that, the new version was still in a private Beta. But you can still check what happened during the Beta here: