19 February: Powerful new themes, site section groups and more

We’ve added some incredible new customization options for your docs site, including new theming options and site section groups that let you create a nav with drop-down menus

✨ New and noteworthy

New themes to modernize your docs site

We’ve just released a new set of themes that make it easier to design an incredible-looking, branded docs site ✨

These are different from the old themes as they apply to the whole site — from the background and header, down to individual elements and icons.

There are four new themes

• Clean – A modern theme featuring translucency and minimally-styled elements. Clean is available for all sites, and is the new default theme.

• Muted – A sophisticated theme with decreased contrast between elements. Muted is available for all sites. If your site previously used the Default header theme with background tinting enabled, it will now use this theme.

• Bold – A high-impact theme with prominent colors and strong contrasts. Bold is available on Premium sites. If your site used the Bold, Contrast or Custom header themes, it will now use this theme.

• Gradient – A trendsetting theme featuring a gradient background and splashes of color. Gradient is available on Premium sites, and is completely new!

These four themes can be combined with any of our other customization options — such as tints, sidebar and list styles, corner styles, and more.

The updated Customization menu also makes it easy to add a tint that compliments your theme perfectly. You’ll see some suggested colors based on your primary color selection, and you can select one with a click to preview it in the menu. You can also simply select your primary color as your tint, or a completely custom color — the choice is yours.

Head into your docs site’s Customization menu to explore your options, and head to our docs to find out more.

Create more structure with site section groups

A few months ago we announced site sections — a new way to add content from multiple spaces to a single site, with tabs along the top to switch between each section.

Today, we’re building on top of that with section groups. As the name suggestions, section groups let you group up a number of sections in a drop-down menu that appears next to other sections in that top bar.

That means you can create a top navigation bar with clickable groups and drop-down menus containing links to other pages, right in your docs site.

You can give your section group a name and icon, and even add descriptions to the sections within them — which will appear below them in the menu — if you want.

You can manage all of this from your site’s Settings tab, in the Structure section.

Improved

• We shipped some changes that make cards more predictable and consistent across desktop and mobile. Depending on the aspect ratio of your uploaded image, cards will display one of two ways on mobile, and will always be cropped to 16:9 on desktop. Head to our updated docs to find out more.

Fixed

• Fixed an issue where imports could fail due to an annotation being referenced multiple times in a Markdown.

• Fixed a bug that meant your site icon could overflow as you scrolled in the Customization menu.

• Fixed a bug in site publishing that caused some active customers to be asked to check out in Stripe unnecessarily.

• Fixed a visual bug with the space skeleton that appears as your space loads in the app.

• Fixed a bug that was showing too many avatars in the space header when collaborating in real-time. You will now only see three again, as expected.

• Fixed a bug that caused a 500 error when you tried to export a PDF of a page or the entire space from within a change request.

---

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.