Migrate your existing knowledge base onto the new suite of customization tools

What is it?

Our previous release "Customization tools for new knowledge bases" required that users start from scratch to take advantage of new customization features. With this update, we offer an easy path for existing customers to migrate their legacy knowledge base to the new platform!

NOTE: This release is only applicable to customers that have legacy knowledge bases to migrate to the new tools. To confirm if you should be utilizing this migration tool, check out your knowledge base dashboard and look for our legacy interface:

If you see a "Configure" dropdown in lieu of the "Customize template" and "Organize categories" buttons, you're already taking advantage of our newest tools!

New customization features in the knowledge base tool are outlined below:

Themes:

Style your knowledge base fonts, colors, buttons, and more using 50+ granular controls in the Theme Editor.
Add custom fonts from the font picker of the theme editor.
More on theme settings in this article.

Navigation menus:

Not only will you be able to style your navigation menu links in the theme editor, but there is now support for dropdown menu items.
You can also reuse existing menus from any Marketing or CMS Hub content.
More on navigation menus in this article.

Editor:

Edit article content in a revamped editor that reflects the look and feel of your configured styles. With this change, the article editor will be more consistent with our website page and blog post editing experiences.
Use Breeze Copilot to edit and generate knowledge content.
Commenting: add comments to individual articles for a collaborative writing process.
(Enterprise only) Approvals: request approval before articles are published live.
One-Click Publish: reduce superfluous clicks when publishing a knowledge base article.
For those who liked the streamlined experience of the old article editor, we have a new Focus Mode for the editor that zooms in on just the core article content.

Management:

(Enterprise only) Limit increase: Accounts with multiple knowledge bases can now add up to 25 KBs!
Refreshed management tools that will allow users to create saved views and easily filter articles using a management screen consistent with other content tools in HubSpot.
Cloning: For the first time, it is possible to clone your knowledge base articles.
Language support: Rather than the 38 supported languages and locales available before, there are nearly 200 languages and locales supported for your articles, consistent with HubSpot's website page and blog post tools.
Header HTML: It is now possible to add header and footer HTML across the entire knowledge base at once. Before, header HTML could only be applied at the individual article level.
Query KB data using GraphQL

→ Please note: Custom themes and developer tools are not supported for the KB at this time.

Why does it matter?

For years, we've been hearing your feedback about the limits of styling knowledge base articles, especially when compared to other types of HubSpot-hosted content like website pages and blog posts. The related post on the Ideas Forum is one of the top ten most-upvoted ideas in HubSpot history.

Simple updates to navigation menu fonts or text alignment were not possible, and knowledge bases often couldn't match the branding of a main website. These updates are a big first step in addressing that pain.

How does it work?

When viewing a legacy knowledge base, users will be given the option to migrate over to our new tools.

Upon confirmation, our migration flow will create a copy of the legacy knowledge base using the new platform and the legacy knowledge base will become read-only. Users will be able to customize dozens of new style fields, review their changes, and then publish their new knowledge base live when they're ready to go. Upon publishing the new knowledge base, corresponding legacy KBs will be unpublished automatically and will be deleted after 30 days post-publish.

Users will have 90 days to begin the migration flow. We'll begin migrating any remaining users over in late November 2025.

Check out this quick overview and get started today!