Hubspot Knowledge Base Article Setup Guide
Using Hubspot to build a clear, searchable knowledge base lets you reduce support tickets and help customers solve problems on their own. This guide walks you step by step through creating, customizing, organizing, and managing articles in your Hubspot customer service hub.
Getting started with your Hubspot knowledge base
Before you begin, confirm that you have the correct subscription level and user permissions so you can access the knowledge base tool.
Check access and requirements
- You need a Service Hub Professional or Enterprise subscription.
- You must be a Super Admin or have permissions to edit knowledge base content.
- Your knowledge base must be connected to a domain in your site settings.
Once you meet these requirements, you can start building articles directly in your Hubspot account.
Create a new Hubspot knowledge base article
Follow these steps to create a fresh article from your service tools.
- Navigate to the knowledge base:
- In your Hubspot account, go to Service > Knowledge Base.
- If prompted, select the knowledge base you want to manage.
- Start a new article:
- Click Create article.
- Choose a template if available, or start with a blank layout.
- Set article basics:
- Add a clear, descriptive title that matches how customers search.
- Write a short introduction explaining what problem the article solves.
- Use headings and bullets to break up longer content.
You can save your work as a draft while you refine the structure and content.
Use the Hubspot editor to format knowledge content
The article editor in Hubspot is designed to keep your support content easy to read and consistent with your brand.
Core formatting options
- Headings: Use H2 and H3 tags to separate concepts and guide readers through steps.
- Text styles: Apply bold, italics, and links only where they add clarity.
- Lists: Prefer ordered lists for procedures and unordered lists for reference points.
Insert media and embeds
Enhance your Hubspot knowledge base articles with visual aids and additional resources.
- Images: Upload screenshots or diagrams that illustrate each step.
- Videos: Embed tutorial videos hosted on your video platform.
- Rich embeds: Insert code snippets, iframes, or other media where relevant.
Always add alt text to images so they are accessible and searchable.
Customize Hubspot article settings
Each article has settings that control how it is displayed, indexed, and categorized in your knowledge base.
Control URL, language, and visibility
- URL slug: Edit the URL to match the topic using simple, keyword-based wording.
- Language: Set the language so your Hubspot knowledge base can group translations.
- Audience visibility: Choose whether the article is public, password-protected, or only for logged-in users.
Optimize SEO details
Configure SEO options to make your support content easier to find via search engines and internal search.
- Customize the page title and meta description to reflect the main question your article answers.
- Use short, readable URLs and avoid unnecessary parameters.
- Include relevant phrases and synonyms naturally in your headings and body text.
Strong SEO in your Hubspot articles improves the overall performance of your help center.
Organize Hubspot knowledge base articles by category
Clear organization makes it easier for customers to navigate your knowledge base and for your team to maintain it.
Create and manage categories
- In the knowledge base tool, open the Categories or organizational panel.
- Create categories that align with your products, features, and common issues.
- Add subcategories where you need more detailed grouping.
Examples of categories might include:
- Getting started
- Billing and subscriptions
- Integrations
- Reporting and analytics
Assign articles to categories
Within each article:
- Open the article settings panel.
- Select the category and subcategory that best describes the topic.
- Update the article so the change takes effect in your Hubspot knowledge base navigation.
Review your structure regularly to keep it aligned with product changes.
Preview and publish Hubspot articles
Before publishing, confirm that your article is clear, accurate, and formatted correctly.
Preview in different contexts
- Click Preview to see how content appears on desktop and mobile.
- Test internal links and navigation between related articles.
- Verify that images, videos, and embeds load correctly.
Publish or schedule
When the article is ready:
- Click Publish to make it live immediately.
- Or schedule a future publish date if you are coordinating with a product launch.
- Share the article URL with your support and success teams.
Once published, your Hubspot knowledge base article becomes available in search and can be linked from emails, chat, and ticket replies.
Maintain and improve Hubspot knowledge base content
Regular maintenance keeps your knowledge base trustworthy and effective.
Update articles as your product evolves
- Review articles after every major feature release.
- Replace outdated screenshots and adjust steps to match the current interface.
- Add clarifying notes or FAQs based on support feedback.
Use analytics to refine content
In Hubspot, view performance metrics for each article such as:
- Views and engagement over time.
- Search terms used to find the article.
- Helpful or not helpful feedback from readers.
Use these insights to improve titles, rework unclear sections, and identify new topics you should cover.
Additional Hubspot knowledge base resources
To see the original technical documentation and feature details, review the official article on how to create and customize knowledge base articles in Hubspot.
If you need strategic help designing your overall support experience, content structure, or automation around your Hubspot implementation, you can work with specialists such as Consultevo for advisory and implementation services.
By following these steps and reviewing your content regularly, your Hubspot knowledge base can become a powerful self-service channel that reduces support load and improves customer satisfaction.
Need Help With Hubspot?
If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.
“`
