Creating & Managing a Knowledge Base: The Ultimate Guide

How to Create, Manage, and Optimize Your Knowledge Base to Improve Customer Success and Happiness

It’s a constant struggle to deliver amazing customer service. When you’re buried in support tickets and live chats, and you find yourself answering the same questions over and over again, it can feel incredibly frustrating.

When you hit this wall, you may think, “How can I scale our customer support? How can I help more customers in less time with the same quality of service?”

→ Access Now: Free Knowledge Base Article Template

Enter customer education, otherwise known as self-serve customer service — or best-known as a knowledge base.

A knowledge base is a library of information about your product or service. It helps customers find answers to solve problems on their own and — if you do it right — a good knowledge base can scale out your customer support program while improving the overall customer experience.

You know how important customer experience is to the success of your company, but did you know that 90% of consumers use customer service and experience as a factor when deciding whether or not to buy from a business? That's a large potential margin of error.

The good news is that there are many ways to provide remarkable customer service. According to HubSpot Research, 62% of customers want to communicate with companies via email for customer service, 48% want to use the phone, 42% prefer live chat, and 36% like "Contact Us" forms.

More than anything, however, consumers want to find answers on their own. A study by Forrester confirmed that customers prefer knowledge bases over all other self-service channels. This is likely because the vast majority of customers want an immediate response to their customer service question — 90%, in fact.

If you’re struggling to keep up with reactive customer service, or if you simply want to invest in building and scaling a greater customer experience, it’s time to look into building a knowledge base.

You can benefit from a knowledge base because it saves you time spend repeatedly answering the same basic questions over and over again.

This guide will serve as a comprehensive resource for creating and managing a knowledge base. Using the chapter links above, feel free to treat this guide like a choose-your-own adventure story and jump to specific sections to read what’s applicable to you — or peruse the whole thing.

What Is a Knowledge Base?

First off, let’s define "knowledge base."

A knowledge base is a self-serve customer service library that includes information about a product, service, or topic. They usually look something like this.

hubspot knowledge base


Knowledge bases may seem like a simple enough concept, but let’s step back and put the idea in context.

Customer service departments exist to improve the customer experience. They ways they do this can vary, but it usually starts out with some sort of ticketing or case management system.

When a user has a question or an issue, they get routed through this system and can get an answer through various channels, including email, live chat, social, etc.

All of this is reactive. And when it comes to reactive customer service, it’s time-consuming (because you have to have well-trained support staff operating these systems and interacting with customers to ensure a good experience) and can get repetitive. For example, if you work at a photo-sharing startup, you might get the same question about how to upload a photo dozens of times per day.

This repetition is valuable, of course. It shows you how your user experience may or may not be intuitive and how it could be improved. But in the m, this reactive repetition is time consuming, stressful, and isn’t scalable.

This is where customer service organizations become aware of the need of knowledge bases. Scaling out your customer success initiatives allows you to be more proactive in creating happy and successful customers — and it saves customer service reps valuable time. Happy and successful customers then often turn into customer advocates, almost becoming an external sales force for your business. And you already know that leads to business success.

hubspot customer service report graph


A knowledge base allows you to create self-service customer support content around recurring topics, issues, and themes. Returning to our photo sharing app example, why not simply create an article to explain the process of uploading a photo? That way, a user can search for and find this article, or you can simply send them the article via your regular ticketing system to save time.

A knowledge base doesn’t simply have to be a reservoir of help center articles. It can also include functions like a frequently-asked questions (FAQ) section, a user forum, articles, white papers, how-to articles, video tutorials, case studies, and dictionaries or glossaries — essentially, anything that helps customers understand and use your products or services.

Technically speaking, a knowledge base could also fall under a few broader use cases. In most contexts, we think of it as an online knowledge base, something that helps customers find answers to common questions.

But you could also set up an IT knowledge base or an internal company knowledge base to help your employers learn how your organization operates, discover benefits and HR information, or get answers to common IT and technical questions.

At its core, no matter the purpose, a knowledge base simply helps users discover answers and achieve success in their endeavors.

For the sake of this article, we’ll focus on customer-facing knowledge bases. Let’s move onto best practices for building a self-serve customer education center.

How to Create a Knowledge Base

The truth is, building a knowledge base doesn’t ensure it will actually be successful (or even useful for that matter). First, the customer has to actually be able to find answers to their questions. This brings user experience, design, architecture, and even SEO into the mix.

Second, they need to be able to understand your help documentation and to be able to take action based on the information. It’s hard to write clear yet robust instructions, but it is possible.

Let's talk about some best practices for building a knowledge base and creating the content.

1. Start with the design and structure.

Let’s start with the design and structure — essentially, the knowledge base article format. Most of these start out at a high-level, almost like a traditional home page for support-based content. This example from Evernote displays that clearly.

evernote knowledge base example


Evernote gives you the opportunity to search for a specific issue, navigate by categories (“Getting Started,” “Tips & Tutorials,” “Troubleshooting”), or search by top articles. You can also check out their other support options like tickets, social media, and their community.

Discoverability is incredibly important when it comes to knowledge bases. If a user has a problem, can they find the solution? Key focus areas here should be in sifting the most popular articles to the home page and making them prominent, as well as improving search functions so users can find their specific problems.

Without diving too deeply into information architecture or user experience design, I want to cover briefly what a good experience might look like with regards to your knowledge base. Here’s a summary of Evernote’s UX:

Video Thumbnail

2. Determine your writing process.

Once you’ve got the navigation and discoverability aspects down, you can start optimizing your process of how to write a successful knowledge base article.

Writing knowledge base articles is not unlike writing educational blog content. In both cases, you want to attract readers with a strong and clear headline, give lucid and helpful instructions, and allow them to walk away with new information or ideas.

Therefore, we can come up with a few general guidelines for writing knowledge base articles:

  • Write a descriptive title.
  • Be descriptive in your content.
  • Avoid typos.
  • Link to helpful resources.
  • Don’t forget user experience and readability (as mentioned above).
  • Add most frequently-asked questions in your support ticket auto-responder or chatbot.

Essentially, the same writing principles that apply to blogs and other nonfiction, instructional formats apply to your knowledge base. Be clear, specific, and descriptive. The addition here is simply to link to as many helpful resources as possible and to prioritize readability and understandability over complexity and nuance.

But wait, that’s only for text-based articles. What about video content?

While there is a debate around which is more effective — text or video-based support content — it’s generally best to combine both. People learn in different ways — some prefer to read, while some prefer to watch.

Here's how Craig Stoss, Technical Support Manager at Vidyard, explains the benefits of using video content in your knowledge base:

Craig Stoss, Vidyard, Technical Support Manager

"A video enabled knowledge base allows you to reach a wider audience while reducing confusion of complex steps. Video allows you to bridge language barriers, knowledge/skill level barriers, as well as some accessibility barriers.

By describing visually, and verbally the actions you wish your users to take, you enable a wider set of your users to be successful. Difficult steps can be shown in place of complicated diagrams, or large lists of written steps. Text translations can be expensive, and can lose specific meaning in translation (especially with proprietary terms or deeply technical or industry specific terms). Text also assumes your user reads and understands at the level of the author, which can lead to confusion and frustration. Video removes these barriers by showing and not telling.Research has shown that searches related to “how-to” on YouTube are growing 70% year over year.

Customers' want to self serve and video is an increasing method to do so. Videos within articles should average between 60-90 seconds long."

As I mentioned, it's best to use a combination of both. Text-based content is more likely to rank on search engines, making it more discoverable to customers searching for solutions. Video content generally allows for more visual tutorials and step-by-step walkthroughs — although video content can rank on YouTube, which is the second-largest search engine after Google itself.

3. Always include helpful visuals.

No matter which format you choose to do, make sure you add some sort of visuals to your content. It really helps visual learners understand what you’re talking about. Usually, simple screenshots with annotation will suffice.

optimzely help center screenshots example


Here are a few more tips on making video content work for your knowledge management from Craig Stoss:

"They should be consistent in their tone, not display private information, and always end with a call to action that guides the viewer on what to do should the video not be helpful.

These videos will increase your customers' ability to self serve, improving customer satisfaction and reducing your caseload all while reaching a wider customer base in the medium they want to use."

Vidyard put together a great article on how you can better utilize video in your customer education if you'd like to read further.

So, you know how to create a knowledge base. Do you know what topics to include in your knowledge base? We dive into that next.

How to Choose Knowledge Base Topics

How do you know what topics to choose for your knowledge base? It’s simple: Look for trends.

When you’re getting the same question over and over again, it’s probably time to write a knowledge base article about it. You can also find bottlenecks in the user experience of your website using tools like HotJar or Usabilla, or even simply by running some user tests to see where people struggle to complete tasks.

The main priority here should actually be to improve the core user experience to remove the usability bottlenecks, but in the meantime, you should definitely still consider writing help documentation to ease the process. No user experience will ever be perfect for all people, and if some are struggling with a task, you can improve their experience by giving them self-serve documentation to figure it out.

Finally, you can find insights for knowledge base articles in your Google Analytics setup. All you need to do is check out your internal site search analytics (make sure it’s enabled). Just go to Behavior > Site Search > Overview to see the common terms people are searching for. (Tip: You can compare time periods and sort by “absolute change” to see rising trends over time.)

google analytics identify trends for knowledge base

Sample view of Google Analytics from my own site

Here's how Lizzie Burns, Content Strategy Manager at SurveyMonkey's Help Center, finds trends for knowledge base content creation:

"Listening to customers is core to who we are as a company. We analyze article traffic, contact rates, and search queries from our help center, then compare it to customer support email data to uncover recurring themes and surface language patterns to create targeted content that resonates with customers.

We specifically focus on data from support emails that present self-service opportunities—common themes that can be answered in only 1 or 2 replies from our customer support team. If a question can be answered efficiently over email, it can likely be solved by self-service content, which means we can make a measurable impact with content improvements in our help center."

Now that we’ve covered how to choose your knowledge base topics, let's talk about how to manage your knowledge base.

Knowledge Base Management & Best Practices

Developing your knowledge base is only half the battle. A remarkable knowledge base is a living document, meaning it needs to be actively managed and updated to best serve your customers. These few best practices will allow your knowledge base to make the biggest impact on your customers and provide help and answers when they need it.

1. Know your audience.

Your marketing team isn't the only team that can benefit from your buyer personas. Reference your customer information when developing your knowledge base. Just as you researched trends to establish your knowledge base topics, use these trends to better understand how to write about and position your knowledge base articles.

You should put as much forethought into your knowledge base articles as you do your blog posts and sales copy. Craft the tone and style in a way that speaks to your audience, keeps them interested, and answers their questions. If they can't understand the answers you're providing, they'll get in touch with your customer service team — which defeats the purpose of proactively providing a knowledge base in the first place.

2. Keep your knowledge base on brand.

Your knowledge base is yet another reflection of your branding. Failing to keep your knowledge base consistent with your brand voice, colors, and design provides a disjointed experience for customers seeking to learn more about your products or services.

Try this: Create a style guide for your knowledge base. Keep it consistent with your overall company branding, and include formatting and writing guidelines specific to your knowledge base articles. This helps keep your knowledge base uniform and professional, no matter who's writing articles or updating content.

3. Consider accessibility.

Your website isn't the only digital space that should follow accessibility standards — your knowledge base should, too. Add alt text for all screenshots, images, and videos included in articles. Check for any contrasting colors that may be tough to see against certain backgrounds or buttons.

Also, use large, clear fonts for headers and bullet points to break up lists. Add hyperlinked tables of contents to help readers navigate long articles. Lastly, confirm your knowledge base is mobile-friendly before launch.

4. Update your knowledge base with every product update or launch.

If your products, services, branding, or company changes in any way, so should your knowledge base. If you neglect your knowledge base content, over time, it'll be useless — and customers will notice. Just as you train your customer support staff on product or service updates, so should you actively update your knowledge base articles. The same goes for creating new articles for new features or entirely new products.

Here's a tip: Only explain major concepts or features once, and simply hyperlink to that article when developing new ones that reference that concept. This helps you avoid having to update content in multiple places.

5. Share your knowledge base everywhere.

A great knowledge base isn't only accessed when needed; it's also used to support marketing content, explain sales presentations, and convert leads. While it's primary purpose is to answer questions and provide support to curious customers, it can hold value elsewhere.

For example, if you're writing a blog post and reference your relevant feature of your software tool, consider linking to a knowledge base article explaining this feature versus the product page. Not only does it provide a more in-depth explanation of the feature, but it also showcases your product in action for those readers who may not (yet) be customers.

6. Measure its effectiveness.

It’s hard to measure the effectiveness of a knowledge base. How do you know if customers are leaving your knowledge base article happily with new knowledge and answers in their head — or if they’re leaving, frustrated and without answers, contemplating changing to a competitor? On the same note, how do you know you’re creating the right content and actually answering everything your customers care about?

There are a few ways to measure how well your knowledge base is working. First, include basic, one-question feedback surveys at the end of each article.  These surveys don't have to be complicated — you could simply ask "Was this article helpful?" and have customers click a thumbs-up or thumbs-down based on whether they found their answers. Secondly, provide an email address or phone number for customers to provide further feedback or ask additional questions. 

You'll only know if your knowledge base is working if you ask the people who you're creating it for — your customers.

Now that we’ve covered some knowledge base best best practices and how to write great knowledge base articles, let’s look at some example of companies that do it really well.

Knowledge Base Templates & Examples

You’ve got a good grasp of the theory and best practice, but what does an effective knowledge base look like? For that, let’s go over some excellent knowledge base examples.

→ Access Now: Free Knowledge Base Article Template

1. Optimizely

Optimizely’s knowledge base is huge, and it contains a community forum, a traditional knowledge base, an educational academy, certification programs, developer documentation, and a link to regular support.

optimizely knowledge baseSource

Here in this image, you notice that three elements are prominent: left-hand navigation, search functionality, and popular articles/common questions. This is just the tip of the iceberg (and it’s a great way to get people started without overwhelming them). When you scroll further, you see the crazy breadth of topics they cover here.

optimizely knowledge base topics

When you click into an individual article, like the following tutorial on personalization targeting, you’ll be pleasantly surprised at the depth and descriptiveness of the content. It’s really easy to walk away from these articles knowing what actions you need to take to get things to work in the product. Good mix of images, video, and text as well.

optimizely knowledge base sample article

You can also see that they frequently link out to other helpful sources within the body content as well as on the sidebar. This helps users find solutions to related issues.

Here’s how Adam Avramescu, Director of Customer Education at Optimizely, talks about their knowledge base:

Adam Avramescu, Director of Customer Education, Optimizely

As an experimentation company, we took a data-driven, iterative approach to our knowledge base. Through experimentation, we questioned common assumptions about how knowledge programs should work and explored search-first vs. browse-first behaviors; article lengths; recommendation algorithms; and more. What we have today is a knowledge base that not only helps customers answer support questions easily, but also serves as a competitive differentiator in the market. When you have a question about Optimizely or optimization, even if you're coming in through organic search, the knowledge base is often the first stop.This builds our customers' and prospects' trust, and shows that we're experts in the field of experimentation."

2. SurveyMonkey

When it comes to a knowledge base design template, SurveyMonkey has one of the best examples I’ve seen. It’s clean, beautiful, simple, and intuitive. I like the visually prominent search bar and the clear topic categories.

surveymonkey help center knowledge base


As a large percentage of your users will use the search feature to find a solution to their specific question, I tested out the functionality here, and it brings up super-relevant search results (but also keeps the categories prominent in case you’d rather browse). In addition, you can see a visually prominent sidebar module to sign up to get faster service, as well as a less prominent module to contact them for support (as a last resort, presumably).

surveymonkey knowledge base help center

When searching, it also helps to have a good autocomplete system to suggest possible questions your user may have. SurveyMonkey has this feature and I can only assume the suggestions are ordered by popularity or some sort of context (or they should be, at least).

surveymonkey knowledge base help center

Finally, when you do click into a knowledge base article, the design is still great, and you get the information you need. More notably, look at the highlighted topic category and navigation breadcrumbs — you know exactly where you are on the site. (It can be stressful to get lost on a website, especially when you’re searching for answers).

surveymonkey help center knoweldge base

Within the article, SurveyMonkey also links to product features like survey templates. This can be helpful to get the user started as well as to simply get them to use the product.

surveymonkey help center knowledge base sending survey

The only thing I can think that they could add is some sort of feedback mechanism to see whether or not an individual article is actually helpful (or how it may be improved). In absence of a feedback related action, it’s really hard to optimize a knowledge base for usefulness.

3. Microsoft

The next knowledge base example we have here does a great job of capturing and utilizing feedback.

I’ve spent a ton of time on the knowledge base for Microsoft Excel (as I’m sure many other people have). It’s generally a really good example of how to build a knowledge base.

 Microsoft knowledge base


The cool thing is that Microsoft has clearly done its research and analysis and has built the knowledge base homepage to reflect top user concerns.

 microsoft knowledge base example featured topics

They also offer trainings and higher-level education on Microsoft Excel.

microsoft knowledge base example featured training

The actual knowledge base article itself is readable, scannable, and helpful. You can jump to specific sections, and they also link out to related content frequently in case you're not in the exact right place. 

microsoft knowledge base if function

Finally, they give you the chance to rate the quality of the article on a binary scale. This helps them measure effectiveness and optimize knowledge base articles as needed.

microsoft knowledge base feedback

4. HubSpot

We focus a lot on customer education here at HubSpot. 

As such, our knowledge base contains a bunch of different elements, including documentation (for developers, designers, and general users), training (online, consulting, and classroom on a variety of topics), certifications, and a huge variety of community features (like forums, case studies, a customer blog, and more).

hubspot knowledge base

Because of the large variety of customer education features, we 1) put a lot of emphasis on our navigation structure and 2) include a prominent search bar feature. This allows visitors to find the specific section of the knowledge base they’re looking for or to search for a specific solution to their problem.

According to Lauren Pacifico, a technical writer at HubSpot who works on the knowledge base ...

“Self-service resources are a critical part of reducing customer friction and deflecting cases from your customer support team.

As creators of those resources, the goal for us is to provide clear, concise information to our customers so that they can find the answers they need quickly and get back to getting things done.”

5. Decibel Insight

Our next example comes from a user experience and conversion optimization powerhouse, Decibel Insight. Their product has many distinct features, so their knowledge base is organized by each function:

decibel insight knowledge baseSource

They also maintain a strong searchability factor on their knowledge base homepage, with a prominent search bar. Just in case you can't find your answer by searching or by scanning, you can raise a support ticket or contact the company at the top right hand of the page. Everything is clear, intuitive, and lacks clutter and complexity:

decibel insight knowledge base search

Looking at the actual knowledge base articles, you'll see Decibel Insight often uses a combination of thorough text instructions and visual video-based education. This maximizes for both dinstinct learning style and the SEO benefits of thorough how-to text:

decibel knowledge base video education

6. InVision

InVision, a product design and prototyping software, also includes a multi-faceted knowledge base — it includes news & release information as well as standard help articles, a contact support option, and a search feature to tie everything together.

invision knowledge baseSource

They also have a status indicator that updates in real time to let you know if there have been any technical incidents. 

invision knowledge base status indicator

Some of their articles are comprehensive and educational, others are more straightforward and feel like scaled out customer support articles. They read like simple FAQs, which, depending on the context, may be just what you're looking for.

invision knowledge base FAQ

7. Moz

Moz is a stellar example of using knowledge base content not simply for reactive customer support, but for proactive customer education as well. They even refer to their knowledge base as a "learning center," which shows you how they're framing their efforts.

moz knowledge base example


You'll notice from the prominent CTA on the home page that they're promoting a guide to SEO. This is different than most knowledge bases, in that it's not explicitly product focused. It's not about what Domain Authority means or how to find it in the tool. It's about SEO more generally and how to excel at the dark art. The rest of the learning center continues on this way, with lessons in many different facets of SEO.

Finally, you get to a point where you can get product specific content. 

moz knowledge base help hub

This breaks down further into different knowledge base sections, such as support community, their outstanding blog, and a video-based academy. Here's an example lesson from their academy:

moz knowledge base support community

Any given product-based help article is high quality, and it includes a variety of teaching styles — step-by-step text, images, video. They're comprehensive and it's hard to imagine walking away without finding your answer.

moz knowledge base videos

Now, we’ve gone through what makes a good knowledge base article, and we’ve also seen a few good examples and templates. Even though, technically, you should do the research on your own to consider what topics you should write about, it’s helpful to have a sort of FAQ template, or at least something to get you thinking about what types of articles to write. So here are a few ideas:

  • When does my order ship?
  • How long will it take to get my order?
  • How can I cancel my subscription?
  • How do I enter a promo code?
  • When do you charge my card?
  • How long does my trial last?
  • How can I get in contact with support?

Same deal with knowledge base articles: if you’re getting the same question over and over, write up an FAQ page for it.

Generally speaking, you want to cover real objections and questions customers may have (not ones imagined by your branding or SEO team). You don’t have to be running a complicated software product for this to be beneficial. Ecommerce companies need to worry about customer success and retention, too. Death Wish Coffee does this well:

death wish coffee knowledge base

Knowledge Base Tools & Software

As companies have increasingly started valuing the idea of creating a knowledge base, it’s been easier and easier to build one — at least from a technological standpoint.

As a result, there is now a variety of knowledge base tools and software for companies of any size or stature. Options range from knowledge base software and FAQ software all the way to enterprise solutions.

To start lean, let’s cover knowledge base software.

New Call-to-action 

First, if you can rig up your CMS software to serve the purpose of a knowledge base, that may work alright for you. So whether you use HubSpot or another system to manage your website content, it’s quite likely you could also use this to set up your customer education content. 

If you’re using WordPress, it’s easy enough to find free knowledge base solutions as plugins - one of the most popular options is the WP Knowledge Base plugin. With this, you simply need to install the plugin, add categories, add articles, and choose a page where your knowledge base will be accessible. Further instructions for building a knowledge base on WordPress can be found here.

Of course, if you’re in search of scalability and flexibility, you may have to use a specific knowledge base solution. While there are many out on the market, you simply have to choose base on the business criteria you’ve chosen. Some questions that may help you choose could be:

  • Is this knowledge base software free? What does it cost?
  • Do we need forum or community features? Is this the best forum software for us?
  • Does this software give us the analytics we need?
  • How is the support for this software?
  • Does the software integrate well with other tools we’re using?

In short, it’s like any other decision where you must weigh the pros and cons and find what works best for you. You might want to check out software review sites like G2 CrowdCapterra or Software Advice. Or simply get on a call with companies you’re interested in to see if they can offer the features and support you’re looking for. 


Building a knowledge base can help you scale out your customer support and customer success efforts — without having to add new customer support staff. As such, it can help you reduce costs, improve customer satisfaction, and boost the ROI of your customer success organization.

In addition, it can help you to focus more on proactive efforts such as customer education and empowerment instead of simply reacting to support tickets. This shift can be a huge organizational win.

There are many ways to build an effective knowledge base, but it all boils down to answering important and frequent issues that come up with customers. 

New Call-to-action

Created By

  • Alex Birkett

    Growth Marketing Manager @ HubSpot

Get early access to knowledge base software

HubSpot is releasing knowledge base software in 2018. Get notified when it's ready for action.