How to build an effective customer support knowledge base

Help your customers succeed with support documentation.

By Melissa King · April 29, 2022

A hero image with an icon representing a knowledge base for a customer support help center

Even if you make your product as error-proof as possible, people are going to ask questions. We all understand the world in different ways—not to mention that accidents happen. So where are your customers going to go when they need that help?

Automation can help your customer support team

Some of them might reach out to your customer support team—but not everybody wants to bring a question to a team member right away, and it saves you resources if you have a self-serve portal. That's why customers need a knowledge base to reference as they figure out your product.

Here's how you can create a dependable help center for your customers in six steps.

  1. Choose what to document
  2. Create easy-to-understand content
  3. Find a good host
  4. Organize your help center
  5. Make your documentation easy to find
  6. Keep improving your documentation

Why knowledge bases are important

Your knowledge base is primarily intended to support customers, but it will also support your business:

6 steps to setting up a help center

Follow these six steps to create a knowledge base your customers can count on.

1. Choose what to document

It can feel overwhelming to fill a knowledge base from scratch, but you'll find most of your topics close at hand. Don't be afraid to start with subjects that seem super obvious.

Look how Google Docs' knowledge base starts with high-level topics.

The landing page of Google Docs' help center

The very first page on the first list is "How to use Google Docs." These topics are the bread and butter of a support center.

Once you run out of obvious subjects to cover, it's time to dig into topics that your customers ask about often. Talk to your support team about the issues they help customers with the most, and look through your support ticket history for patterns.

After you have your knowledge base running, you can automate some of this process with Zapier. For example, in his article on customer support automation, Tyler Robertson shares some Zaps (automated workflows) that help you turn common questions into help center articles.

2. Create easy-to-understand content

Good formatting and simple language improve a customer's chance of finishing a help doc feeling like you answered their question. Use these guidelines to write more understandable documentation.

Explain every little detail

Never assume that your customers know what you're talking about. Explain every topic as though you're talking to someone completely new to your product. When in doubt, over-communicate.

This principle doesn't mean you have to re-explain yourself over and over again, of course. Link back to other help center articles when you're explaining a topic you already covered.

Use multimedia

Nobody said that help center articles have to be text only. Add images and videos wherever you think they can help you explain something. Have a topic a little too complicated for an image, but not complex enough for a polished video? Grab your favorite screen recording software for a quick screen capture.

Notion uses short videos in their documentation to explain features all the time, like in their "What is a block?" article.

Write in simple and consistent language

The words you use in your documentation matter. Use easy-to-understand language that stays consistent throughout your help center and website.

Before you write your knowledge base content, create a basic style guide to establish your voice and tone. If you already have a style guide for your main website's content, feel free to adapt it. Many folks use Mailchimp's and Buffer's style guides as a reference for their own.

Regardless of your brand's established style, keep your help center content's language as simple as possible. Practice accessible writing, and use consistent terms for technical features.

Format for easy reading

Space out large blocks of text by writing in short paragraphs, breaking up text with images, and using bullet points—all of which will create a more skimmable resource. These bits of formatting will also serve as "landmarks" for your readers when they're going back and forth between your help center and product.

Discord does a fantastic job of balancing their text in their "Custom Emojis" article:

Discord's

Headers, colors, bullet points, and a GIF—they pull out every trick in the book to share information in digestible pieces.

3. Find a good host

Your documentation needs a home. Businesses generally take one of three approaches when finding a place to share their knowledge base:

You can use Zapier's pre-built request portal template, which enables your clients to seamlessly navigate and interact with different resources so that they can get the answers they're looking for. Offer a centralized hub where your customers can quickly create a support ticket, book a demo, read through FAQs, or get up to speed on the latest company news.

4. Organize your help center

Most knowledge bases follow an established order to help customers find information easily.

Near the top or center of an organized help center, you'll find a search bar dedicated to support articles. Knowledge base apps usually have them built in, or if you're hosting your own, try using Google's Programmable Search Engine to make a custom search bar.

Some help centers have a "Getting Started" section at the beginning of their main page. It includes the fundamental help articles a customer needs to start using a product, such as main feature overviews and quick-start guides. Storyblok links to a dedicated "Getting Started" page at the top of its help center home:

Storyblok's help center home page, with a getting started guide featured at the top

If you notice customers looking up specific topics more than others, add a "Frequently Asked Questions" section to your main page. Zapier has one for common questions related to syncing and Zap speed:

Zapier's FAQ section on its Help Center home page

After you decide whether to include these sections, organize your documentation into categories based on topic. Divide them into lists or their own pages, as Wave does:

Wave's Help Center, organized by topic with icons for each topic

Within each of the categories, list your help articles in a logical order. For example, if you run document editing software, you'll want to teach customers how to create a document before you show them how to write in it. Miro explains how to create a profile and board before teaching you how to collaborate with others in the app:

Miro's Getting Started section

5. Make your documentation easy to find

Now that you've put so much hard work into creating and organizing your help center, you want your customers to read it. Be sure to link to your documentation where your customers will first expect to find it.

The most popular places to link to a knowledge base are in the main website's header and footer. While most sites link to it in one of those places or the other, Zapier links in both locations.

The help center featured in the Resources dropdown menu of the Zapier blog

The Zapier footer featuring the Help page

If your product is an app, add a link to your documentation in its menu. Did you ever notice that Gmail has a nifty link to Google support in the upper-right corner of your screen?

The link to Help from Gmail

As you get your knowledge base established, help customers remember to use your documentation through support communications. For example, coach your support team to link to relevant help articles when talking to customers. That way, the next time those customers have a question, they'll know they have a help center handy.

6. Keep improving your documentation

Your knowledge base will always be a work in progress. As you roll out and retire features, your documentation should change with your product. You'll also want to keep an eye on your help center's usefulness for customers.

The methods for measuring your knowledge center's utility will depend on your hosting choice. Help center tools have features like page analytics and a button at the end of each article asking the reader if it was useful. If you went the DIY route, though, you'll need to get creative. Use an online survey app to ask customers for input. Then, combine that info with other feedback into a customer feedback database.

Integrate your documentation into your unified communications

Your help center connects to many other aspects of your business. To get the most out of your knowledge base, integrate it into other parts of your operations—for example, your sales team could also benefit from reading and sharing help articles. Continue brainstorming ways to include your documentation in unified communications to keep your customer interactions consistent across all channels.

This post was originally published in December 2015 by Jess Byrne. The most recent update was in April 2022.

Get productivity tips delivered straight to your inbox