Migrate your knowledge base (BETA)

You can migrate your existing HubSpot knowledge base to use the new knowledge base editor. This will give you access to more features, including more styling options, custom header and footer HTML, and additional supported languages. 

Please note: all knowledge bases not migrated by April 2025 will be automatically switched over to the new tools at that time. 

• In your HubSpot account, navigate to Content > Knowledge Base.

• If you have multiple knowledge bases, click the Knowledge base dropdown menu and select a knowledge base. Update available will appear next to knowledge bases that need to be migrated. 

• In the An update is available for this knowledge base banner at the top of the page, click Migrate now. 

• In the dialog box, review the differences between the new and existing knowledge base types, then click Update now. 
• Once the migration has begun, the following will occur: 
  • A copy of the knowledge base will be created using the new platform. 
  • Each article will be moved to a temporary URL, with /migrated/ at the end of the original link. These links will be live but not accessible to visitors from your knowledge base. 

• • The original version of the knowledge base will become read-only but remain live until the new version is published. 

• Once the migration has completed, review the new knowledge base and make any necessary changes using the new tools. 
• Publish the articles on your new knowledge base:
  • In your HubSpot account, navigate to Content > Knowledge Base.
  • If you have multiple knowledge bases, click the Knowledge base dropdown menu and select the new knowledge base.
  • At the top of the page, click Publish in the banner. 

• • In the dialog box, review the consequences of publishing your updated knowledge base, then click Publish. 

• Once your knowledge base is published: 
  • You can no longer publish articles to your original knowledge base. 
  • You will retain access to the original knowledge base for 30 days, after which it will be permanently deleted. 

• • For each article published, its original article will be unpublished. This process can take up to 10 minutes, during which time a mixture of legacy and new articles may be live. 
  • All articles will be published on their original URLs.