How to Build a Knowledge Base Customers Actually Use

The Helpdesk team··3 min read

A good knowledge base answers customers' questions before they need to ask, at any hour, without your team lifting a finger. A bad one is a graveyard of outdated articles nobody finds. This guide shows how to build a knowledge base that people actually use, starting small.

Why bother?

  • Customers often prefer to help themselves. Many would rather read a clear answer in thirty seconds than wait for a reply.
  • Fewer repeat questions. Every article that answers a common question is a conversation your team doesn't need to have.
  • It powers your AI assistant. An AI chatbot that answers from your help center is only as good as the articles behind it. Better articles mean better automatic answers.
  • It brings in search traffic. Public help articles rank for the exact questions people type into Google.

Step 1: Find the questions you answer most

Don't start with a blank page. Start with your inbox. Go through the last month of chats, emails and tickets and list every question. Group the duplicates and count them. In most businesses, a short list of questions makes up a large share of all contacts.

Those are your first articles. Ten to fifteen good articles beat a hundred thin ones.

Step 2: Organise by what customers want to do

Group articles into a handful of categories named in the customer's words, not your internal team names:

  • Getting started
  • Orders & delivery
  • Billing & payments
  • Account & settings
  • Troubleshooting

Five to eight categories is plenty to begin with. If a category has only one article, merge it into another.

Step 3: Write one answer per article

Each article should answer one question, and its title should be that question or task, phrased the way customers say it: "How do I change my delivery address?", not "Address management".

A structure that works:

  1. The answer first. One or two sentences that solve it for most people.
  2. Steps. Numbered, one action each, with the exact names of buttons and menus.
  3. Exceptions. "If you paid with PayPal…", "If the order has already shipped…"
  4. What next. A link to related articles, or how to contact you if this didn't help.

Write short sentences. Use screenshots only where words get confusing, since they go out of date faster than text.

Step 4: Make it easy to find

  • Search. Most visitors search rather than browse. Make sure the search box is the first thing on the help center home page.
  • Link from where questions start. Link articles from your checkout, account pages and order emails.
  • Suggest articles in the chat. When a visitor starts typing a question in your chat, suggesting matching articles answers many of them on the spot.
  • Let Google index it. Keep public articles public, with clear titles and descriptions.

Step 5: Keep it current

An outdated article is worse than none, because customers trust it. Build a few habits:

  • Update articles in the same week a product or policy changes. Put it on the release checklist.
  • Watch for "this didn't help". Articles that lead to a chat anyway need rewriting.
  • Add an article every time you answer something new twice. If a question comes up twice, it'll come up again.
  • Review the top 20 articles every quarter. Those carry most of the traffic.

Measure what matters

  • Searches with no results: these are the articles you still need to write.
  • Most viewed articles: keep these perfect.
  • Contact rate: are fewer people contacting you about topics you've covered?

Start this week

Pull last month's questions, write the top ten articles, and publish. You can expand from there. Our help desk includes a public help center with categories, search and article suggestions inside the chat, and the AI assistant reads it automatically. Create your help center free.

Keep reading