An Easy Guide to Writing Effective Knowledge Base Articles [+ Templates]

Swetha Amaresan
Swetha Amaresan

Published:

Raise your hand if you like waiting on hold for customer service?

Service rep using knowledge base templates

When faced with calling customer service versus finding the answer ourselves, we'd much rather solve problems on our own.

Having a webiste with a knowledge base empowers customers to reslove their issue without needing to contact customer service. This isn't exactly the best news for someone in customer service, but it doesn't mean your job is becoming obsolete. Rather, it's evolving to fit the changing needs of customers.

→ Access Now: Free Knowledge Base Article Template

Creating an effective knowledge base is a big undertaking. We've put together a handy knowledge base template to take the guess work out of helping customers find the resources they need.

What Is a Knowledge Base?

Knowledge bases are online databases that store information about a specific company, its products or services, or related industry topics. The data is either collected and stored through artificial intelligence or manually uploaded by expert contributors.

A company's knowledge base can provide valuable information to customers, prospects, and even employees. You can include important facts about each department, directions for product or service usage, FAQs, and original content that can provide in-depth solutions.

HubSpot's knowledge base helps us better serve and delight our customers by helping them access the solutions they need 24/7. Knowledge bases have also decreased the need for customers to search for questions on search engines. They can simply search the same question on your company's knowledge base, knowing the answer will exist in relation to the appropriate product or service.

These articles also don’t have to be limited to written content. They can come in the form of an infographic, video, gif, or other visual aids.

Knowledge base articles allow users to find the information on their own and resolve issues at their own pace while also freeing up time for your customer service agents since they won’t have to answer the same, repetitive questions. Common types of knowledge base articles include:

  • FAQs
  • How-tos
  • Troubleshooting guides
  • Tool descriptions
  • Informational
  • Industry guides

It's evident knowledge bases are an invaluable resource to both your company and your customers. But, how do you go about creating one?

How to Write a Knowledge Base Article

When a customer is looking for a solution to a problem, your knowledge base should make it as easy as possible to find answers. It's important that your knowledge base articles not only contain the solution that the customer is looking for, but is also formatted in a way that makes the answer clear and obvious. When writing new articles for your knowledge base, check out this guide for writing effective knowledge base articles.

Featured Resource: Knowledge Base Article Template

HubSpot free Knowledge Base templateDownload the Free Template Now

1. Select simple titles using target keywords.

Knowledge bases are mainly for your customers and prospects, and not internal stakeholders. Thus, the language being used in the titles and articles should be simple, clear, and concise.

When choosing titles, put yourself into the customer's shoes. What kinds of topics would they search for? What's their expected difficulty level in terms of knowledge on the product or service? Write titles based on this information. It's also helpful to use search-engine-optimized keywords in the title to attract more search volume.

The most common titles start with:

  • How to [insert topic]
  • Setting up [insert topic]
  • Using [insert topic]
  • Getting started with [insert topic]

It's also helpful to use search-engine-optimized keywords in the title to attract more search volume. In addition to the list above you can also title articles based on the actions your customers will be taking. For example you could write “Creating your first video” or “Installing a widget.”

2. Only have one article per specific topic.

It's inefficient to have more than one article for the same topic. Not only does this split traffic between multiple articles, but it can get confusing for customers if they have to keep switching back and forth between multiple pages to find all the information they need.

If you gain more information on a topic, do a keyword search to see if there are any articles with similar keywords. If so, you can update the existing article with more information.

This will make the article more all-encompassing so readers can gain all the information they need from a single source.

If you’d like to cover a related topic, you can link to it in the existing article. We’ll discuss covering related topics later on in this post.

3. Categorize articles for easier browsing.

Knowledge bases aren't just for searching. While many customers will search specific questions to solve problems, they may also use the database as a way to browse through related topics. This means your articles should be categorized by sections and subsections.

For example, on HubSpot's knowledge base, you can search by HubSpot product, the type of resource, or a variety of topics, such as Blog, Dashboard, Emails, Integrations, and Sales Templates.

Knowledge Base example: PinterestImage Source

Pinterest's knowledge base for business (pictured above) groups articles with easy categories like Create a shop, Advertise, and Create content to help users quickly identify the articles of interest.

Using categorieskeeps the knowledge base organized and ensures every article has a place and a purpose.

4. Include a table of contents, if needed.

Sometimes, an article can get pretty long, especially if you've updated it with added information. Dedicated customers will scroll until the end when they want an in-depth, complete understanding of the problem and solution.

Knowledge base example: HubSpot table of contentsHowever, the sheer length of an article could deter some readers. So, for longer articles, consider adding a table of contents that allows users to jump sections like in the HubSpot article above. This will help people find the sections of the article that they're specifically interested in and skip any information they don't need.

5. Describe the problem, if applicable.

Start off the article by stating what the problem is, for scenarios that are problem-solution based. Not all knowledge base articles are meant to solve problems; some may just explain how to complete a task. In those cases, you can skip this step.

Identify what the symptoms of the problem are to clearly relay what customers should be looking for. For example, list what error messages should be popping up if the problem does exist. You want to use basic language and make it as clear and concise as possible. The briefer this section is, the better, as people reading will likely be looking to get to the steps to solve their problem quickly.

6. Relay the steps to accomplish the task at hand.

After stating the problem, you should immediately jump into showing readers how they can solve the problem. Lay out this section in easy-to-read steps that can be read and followed in succession. You want to make sure the steps actually solve the problem they claim to solve. If the problem can't quite be solved, the steps can help eliminate potential causes or reveal what the root problem is.

You'll want to lay out steps specifically for articles that are solving problems or showing how to accomplish a task. A quick and easy way to do this is by using a tool like HubSpot's free Guide Creator. This Chrome extension uses AI to capture step-by-step instructions with images as you complete your task.

For comprehensive guides, you might not need to utilize steps. Instead, you can divide up the text by explaining different aspects under separate headers.

7. Announce what the solution should be.

You should end the article by describing what the solution is. After all, since not every problem can be completely resolved, the solution may be an improvement of the problem or an update of a product to avoid a former glitch. If needed, you can explain why a permanent solution couldn't be attained but that the solution laid out is the best case scenario for improving their situation.

If there's no direct solution, or if the end result is self-explanatory, this step may not be needed. Instead, you can reiterate in the final step or paragraph that you've reached the end and that the task has been achieved.

8. Offer other article links for further reading.

You never know if you've completely exhausted a topic for interested readers. Rather than making them browse through related articles on their own, you can link some of your other articles at the bottom or side of the article.

This will help customers gain a more well-rounded education on the topic at hand. And, it helps get more eyes onto the articles you and your team worked hard to create. The more your readers use your knowledge base, the more they'll trust your organization as a source of accurate information.

These steps can help you create knowledge base articles that are effective and clear. However, not every article will be structured in the same format. Articles can vary in layout and design depending on the solution they're providing.

9. Show, not tell.

When trying to explain a concept or deliver instructions, visual aids can work wonders to communicate your ideas. This is especially true when you’re trying to explain a complicated topic.

Rather than just posting a wall of text instructions, consider using photos, charts, video and other media to help the reader gain understanding. This method can be super helpful when describing a multi-step process.

Knowledge base example: Semrush visual aidsImage Source

Semrush uses a combination of photos and gifs to walk readers through checking their online visibility. This way readers get a step-by-step visual breakdown showing how to complete the task.

Words are great, but can easily be misinterpreted. Showing users how to solve their issue rather than just telling them will help them follow along and accomplish their task.

10. Ask for feedback.

While you may think you have the best knowledge base out, you should always strive to make it better. Who better to help you with that than the people who use it?

Each article should have a spot where users can submit their feedback. The CTA should be as simple as possible and not require a heavy lift on the user’s behalf. Instead you can ask them a simple question like “Was this article helpful?” or “Did this article resolve your issue?” with a simple yes or no option response.

knowledge base example: Semrush feedback surveyImage Source

Semrush, pictured above, uses a simple thumbs up or thumbs down symbol to solicit user feedback. It’s quick and effective. For those that answer “no,” you can add a text box pop up for users to further explain what went wrong. Understanding the user’s pain points and making adjustments will improve user experience and the effectiveness of your knowledge base.

Knowledge Base Article Templates

The structure of a knowledge base article plays a major role in the piece's clarity and appeal. Customers are looking for specific and concise answers, and don't want to waste time scrolling through an essay to find it. Utilizing the common knowledge base article templates can play an instrumental role in determining the effectiveness of your self-service customer support.

1. How-To

knowledge base template: how-to article

Image Source

How-to articles are typically brief. They show you exactly what steps to take to complete a specific task or perform a certain function. This is usually the type of knowledge base article that helps visitors solve problems they're facing with their products.

Template:

How to [Name of Task]

Applies to [Your Appropriate Products]

[Brief Description of Problem, if Needed]

  • [Step 1]
  • [Step 2]
  • [Step 3]
  • [Etc.]

[Brief Description of Solution, if Needed]

Related Articles:

[Three to six articles with links]

2. FAQ

knowledge base template: FAQ

Image Source

FAQ articles include a list of questions about the same, related topic on a single page. This includes general and tool-specific questions. They're usually all listed at the top in a table of contents with anchor links that allow you to jump down the article to the specific question you need to be answered.

Template:

[Topic Name]: Frequently Asked Questions

Applies to [Your Appropriate Products]

[Brief Description of Topic]

Table of Contents:

General:

  • [Question 1]
  • [Question 2]
  • [Etc.]
  • [Question 1]
  • [Question 2]
  • [Etc.]
  • [Question 1]
  • [Question 2]
  • [Etc.]
  • [Section 1]
  • [Section 2]
  • [Etc.]
  • [Section 1]
  • [Section 2]
  • [Etc.]
  • [Section 1]
  • [Section 2]
  • [Etc.]

[Tool-Specific Category 1]

[Tool-Specific Category 2]

[Etc.]

General:

[Question 1]

[Answer 1]

[Question 2]

[Answer 2]

[Etc.]

Related Articles:

[Three to six articles with links]

3. Tool Description

Knowledge base template: tool description

Image Source

Tool description articles give a short description of what a specific tool or function is. Rather than answering questions or laying out steps, it tells you exactly how something works.

Template:

[Tool or Function]

Applies to [Your Appropriate Products]

[Brief Introduction of Tool or Function]

[Description of Tool]

[Final Tips/Information to Note about the Tool]

Related Articles:

[Three to six articles with links]

4. User Guide
knowledge base template: user guide

Image Source

User guide articles are long, comprehensive guides that cover an entire tool or function. Similar to an instruction manual, they include information on using every single feature to give you a well-rounded education on the tool or function.

Template:

A Guide to [Tool or Function]

Applies to [Your Appropriate Products]

[Brief Introduction of Tool or Function]

[Main Feature 1: Description]

  • [Sub-Feature 1: Description]
  • [Sub-Feature 2: Description]
  • [Sub-Feature 3: Description]
  • [Etc.]
  • [Sub-Feature 1: Description]
  • [Sub-Feature 2: Description]
  • [Sub-Feature 3: Description]
  • [Etc.]

[Main Feature 2: Description]

[Etc.]

Related Articles:

[Three to six articles with links]

5. Quick Answers

Knowledge base template: quick answers

Image Source

Quick answer articles highly resemble user guide articles. They, too, are long, comprehensive guides that cover an entire tool or function. However, the difference is that quick answer articles include a table of contents in the form of anchor links -- like FAQ articles -- that allow you to jump down the article to the specific topic you want to learn more about.

Template:

A Guide to [Tool or Function]

Applies to [Your Appropriate Products]

[Brief Introduction of Tool or Function]

Table of Contents:

[Tool-Specific Category 1]:

[Tool-Specific Category 2]

[Tool-Specific Category 3]

[Etc.]

[Tool Specific Category 1]:

[Section 1]

[Description]

[Section 2]

[Description]

[Etc.]

Related Articles:

[Three to six articles with links]

It's always helpful to include screenshots as examples for any tools, functions, steps, or descriptions that may be confusing to explain in words. Also, by showing your text alongside a visual, readers can follow along on their own product while reading your knowledge base and compare their progress.

Create Your Knowledge Base

Knowledge bases empower customers with the information they need to resolve issues and allows your service team to have some variety in their work day. Keep your articles clear, descriptive, easy to navigate, add helpful visual aids and you'll be sure produce resource that delights customers.

Editor's note: This article was originally published in March 2019 and has been updated for comprehensiveness.

New Call-to-action

 

Topics: Knowledge Base

Related Articles

We're committed to your privacy. HubSpot uses the information you provide to us to contact you about our relevant content, products, and services. You may unsubscribe from these communications at any time. For more information, check out our Privacy Policy.

A free knowledge base article template (+4 other free templates).

Service Hub provides everything you need to delight and retain customers while supporting the success of your whole front office

START FREE OR GET A DEMO