The State of Docs Report 2025 is live! Dive in and see why docs matter more than ever:
Read the report
PricingLog inSign up

10 June: New customization styles, email improvements, dark mode cover images and more

You can now add circular buttons, choose flatter design elements, and select cover images specifically for light and dark mode in GitBook

✨ New and noteworthy

New depth and circular corner styles in site customization

We’ve added two new style options to customization settings for your docs site.

Firstly, we’ve added a new Depth style setting in the Site styles panel, which lets you choose from two depth options. ‘Subtle’ is the default style, and adds some shadows and elevation to UI elements like buttons. The new ‘Flat’ style removes all shadows and elevation for a clean, simple look.

We’ve also added a third corner style in the same panel. Along with our existing ‘Straight’ and ‘Rounded’ options, you can now also choose ‘Circular’. This will affect UI elements such as buttons, TOC highlights, site sections and more.

This site is using a combination of circular corners and a flat style

Cover images get dark mode support

Your page cover images no longer have to work for both light and dark mode simultaneously. Now, when you add a cover image to a page, you can also upload a dedicated version of the image to display when your docs are viewed in dark mode.

To do this, simply hover over the cover image in the editor and open the Options menu . Here you can choose Replace image and select a new image for light or dark mode.

New notification email design

We’ve improved the design and information included in the notification emails you receive when someone comments on a space or a change request your own.

The new design includes the name of the change request or space, and the page, instantly giving you more context without needing to click through and read more.

We plan to roll out similar improvements to our other notification emails soon — stay tuned for more news on that!

Improved

  • We now make sure we bust the cache whenever published content changes — which means you should see updated content right away when you merge a change request.

  • It’s now easier to deselect a selected block. When a block is selected you can now click anywhere else in the document to unselect it — before you had to select another block.

  • When you want to resize an image, the currently-selected size is now highlighted in the UI so you can easily see the current size setting.

Fixed

  • Fixed a bug that meant the Publish button would still show for some sites that were already published using share links.

  • Fixed captions for code blocks. The caption box now adjusts to fit longer captions — including captions that run across multiple lines — and hitting Esc in a caption now selects the entire block as expected.

  • Fixed a bug with tab blocks that meant hitting backspace in an empty tab would delete it and move to the previous tab. This no longer happens, so you can continue editing the empty tab.

  • Fixed an issue that could caused dropdown menus and palettes to be incorrectly positioned, especially on smaller screens.

  • Fix a bug where content could disappear when you scrolled horizontally in large tables with lots of rows and columns.

  • Fixed an issue with DNS validation for custom domains.

  • Fixed an issue that prevented you from selecting multiple blocks and turning them into reusable content.

  • Fixed a bug with block selection that meant you couldn’t convert a single list block item into a different kind of list block type.

  • Fixed an issue where that meant members with Creator permissions could not change site plans.

We’re constantly working to improve 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

Was this helpful?