Create and customize knowledge base articles

In your knowledge base, you can create articles that answer questions visitors may have about your business. 

Before you get started

Before you begin working with this feature, make sure to fully understand what steps should be taken ahead of time, as well as the limitations of the feature and potential consequences of using it. 

Understand requirements

• To create knowledge base articles, users will need Knowledge base articles permissions with the Edit access and Publish access toggled on.
• In HubSpot accounts created on or after March 5, 2024, users must have an assigned Service Seat to create and edit knowledge base articles. Learn more about HubSpot's seats-based pricing.

Understand limits & considerations

• These tools are only available for newly created and migrated knowledge bases. Any knowledge bases not migrated by June 2025 will be automatically switched over to use these tools.
• HubSpot accounts with Service Hub Professional subscriptions can create one knowledge base, with up to 2,000 articles.
• HubSpot accounts with Service Hub Enterprise subscriptions can create up to 25 knowledge bases, with up to 10,000 total articles. 

Create and edit your knowledge base articles

Once you have created your knowledge base, you can create knowledge base articles. You can also import knowledge base articles. Learn more about importing knowledge base articles.

• In your HubSpot account, navigate to Content > Knowledge Base.
• In the upper right, click Create article.
• In the article editor, enter a title and subtitle, then write the body of the article. 
• In the rich text toolbar, you can apply limited formatting and add assets like videos, links, and images. Learn more about editing content with the rich text toolbar. 

Please note: some styling options like colors and fonts must be edited in the knowledge base's theme.

• To customize the article's settings, click the Settings button at the top right: 
  • By default, the article's URL will end in a URL slug of its title. To customize the URL slug:
    • Enter a new URL slug in the URL field.
    • To edit the root URL for all knowledge base articles, click Edit the root URL in settings. You will be redirected to the knowledge base settings page.

• • To set the language of the article, click the Article language dropdown menu and select a language. Learn more about managing knowledge base articles in multiple languages.
  • To assign a category to this article, click the Category dropdown menu and select a category.
    • To add this article to a new category, click the Category dropdown menu, then click Create new category. 
    • On the category creation screen, enter a name and description for the category, then click Create. Learn more about using categories in a knowledge base. 
  • To assign a subcategory to this article, click the Subcategory dropdown menu and select a subcategory.
    • To add this article to a new subcategory, click the Subcategory dropdown menu, then click Create new subcategory.
    • On the subcategory creation screen, enter a name for the subcategory, then click Create. Learn more about using subcategories in a knowledge base. 
  • To add a tag to the article, click the Tags dropdown menu and select a tag, or type a new tag, then click + Add "[name of your new tag]" tag. Adding tags to an article will widen the search results it appears in. 
  • To add a meta description to the article, enter a description in the Meta description field. This description will appear in search results below the article title. 

• • To change the visibility of the article, select an option in the Control audience access section: 
    • Select Public to make the page's content available to any visitor. 
    • Select Private - Single sign on (SSO) required to require visitors to log in with your SSO provider. This option is only available if SSO has been set up for the domain where your knowledge base is hosted. Learn more about setting up SSO for your content. 
    • Select Private - Registration required to require visitors to register with your site to view this article. Learn more about setting up registration for private content.