Skip to main content

Customer Support Knowledge Base: How to Build One Your Team and Your Customers Actually Use

Most knowledge bases get written once and then slowly go out of date. A support knowledge base that works is small, owned by someone, and tied to the tickets that come in. Here is how to build one.

The WeldSuite Team6 min read

What a customer support knowledge base is

A customer support knowledge base is a collection of articles that answer the questions customers and support agents ask most often. Customers use it to solve a problem without waiting for a reply. Agents use it to give the same answer every time.

Key takeaways

  • A customer support knowledge base is a set of answers to the questions your customers really ask. It is not a manual for the whole product.
  • Most knowledge bases fail on upkeep, not on writing. Give every article an owner and a reason to be reviewed, or it will quietly go wrong.
  • The best source of new articles is your own ticket queue. If the same question shows up three times, it needs an article.

That is the whole job. It is not a place for release notes, a full product manual, or every policy the company has ever written. The more you pile in, the harder it is to find the one answer someone needs at 4:45 on a Friday.

It also does more than save time. When the knowledge base is good, ticket volume drops for the simple questions, and the tickets that remain are the ones that need a human.

Why most of them fail

Almost every knowledge base starts well. Someone spends two weeks writing forty articles, the team is pleased, and the link goes in the footer. Six months later a third of the articles describe screens that no longer exist.

Nobody owns it

If an article belongs to everyone, it belongs to no one. Nobody feels responsible for fixing it when the product changes, so it stays wrong. A customer follows the steps, gets stuck, and opens a ticket anyway. Now you have a ticket and a customer who trusts your help center a little less.

It is written for the company, not the customer

Internal names creep in. So do long introductions. Customers search for "can't log in" or "change invoice address", not for the feature name your product team picked. If the title does not match how people ask, the article will not get found.

It is built once and never connected to the tickets

The queue already tells you what customers are confused about. If the knowledge base is a separate project that nobody looks at while answering tickets, you are guessing instead of reading the answer sheet that arrives every day.

What to put in it

Start small. Ten good articles beat a hundred average ones. Pull the last month of tickets, group them by question, and write for the biggest groups first.

Article typeExampleWhy it earns its place
How-toHow to change the billing contactStep by step, one task, one outcome. These deflect the most tickets.
TroubleshootingWhy a password reset email does not arriveWritten around the symptom the customer sees, not the cause you know.
PolicyRefund and cancellation termsGives every agent the same answer, so two customers never get two different rulings.
Getting startedYour first week with the productCatches new customers before their confusion turns into a ticket.

Write the way you would explain it to a colleague. Short sentences. The answer in the first two lines. Numbered steps when order matters. A screenshot only where words are not enough.

How to keep it current

Upkeep is where the work really is. A few habits do most of it.

  • Give each article an owner. One named person per topic area is enough. When the product changes, they know the article is theirs to check.
  • Tie reviews to releases. If a feature changes, the related articles go on the checklist before it ships, not three weeks after.
  • Turn repeat tickets into articles. When an agent answers the same question a third time, that is the signal. Write it up, then link it in the reply.
  • Link the article in the reply. Agents who paste the article link teach customers where to look next time.
  • Retire what is dead. An old article that is wrong does more harm than a gap. Delete it or fix it.

It also helps to watch the ratings. If customers keep marking one article as unhelpful, that is a free bug report. Read it, fix it, and move on.

What to check in the software

You can run a knowledge base from a shared document. Once the team grows, it helps to have it connected to the help desk. A few questions to ask before you pick a tool:

  • Does it live next to the tickets? Agents should be able to find and share an article without leaving the conversation.
  • Can automation use it? An assistant that answers common questions straight from your articles saves the most time, but only if it reads from the same place your team writes.
  • What happens when it cannot answer? The handoff to a person should carry the whole conversation, so the customer does not start again.
  • Is it priced per seat or per feature? Some tools lock the knowledge base behind a higher tier. Ask early.
  • Does it fit your wider setup? If tickets, customer records and articles live in different tools, you pay for it in switching between tabs. Our guide to omnichannel support covers the same problem across channels.

How WeldDesk handles it

WeldDesk is the help desk built into WeldSuite, and it includes a knowledge base alongside the ticket queue. Agents write and find articles in the same place they answer customers. WeldAgent can answer common questions from the knowledge base through a no-code agent builder, and it passes anything it should not decide alone to a person, with the full conversation attached.

You set the limits. Guardrails such as refund caps and VIP handling decide what the assistant may do by itself, and SLA management keeps the clock running on whatever lands in the queue. Conversations from email, live chat, Slack and Discord arrive in one inbox, and contacts link into WeldCRM automatically, so an agent can see who they are talking to. Reviews and ratings show you which answers are working.

WeldSuite is a complete software suite for mid-sized and larger teams, priced per user per month, and WeldDesk is included in every plan. Free is $0 for a single seat. Business is $49 a month, or $42 per user per month billed annually, for one to ten seats. Scale is $69 a month, or $59 per user per month annually, with unlimited seats. Enterprise is custom, with SSO and SAML, data residency and a 99.999% uptime SLA.

Sources

  1. Wikipedia: Knowledge base https://en.wikipedia.org/wiki/Knowledge_base
  2. Wikipedia: Customer service https://en.wikipedia.org/wiki/Customer_service

Frequently asked questions

What is a customer support knowledge base?

It is a set of articles that answer the questions customers and support agents ask most often. Customers use it to solve problems on their own, and agents use it to give consistent answers.

How many articles does a knowledge base need?

Fewer than most people think. Ten to twenty articles covering your most common tickets will do more than a hundred that nobody maintains. Add more as the queue shows you new repeat questions.

How do I keep a knowledge base up to date?

Give every article an owner, add article reviews to your release checklist, and read the ratings. Articles that customers mark as unhelpful are the first ones to check.

What is the difference between a knowledge base and an FAQ page?

An FAQ page is a short list of common questions on one page. A knowledge base is a searchable library of articles that goes deeper, covers more topics and can be shared by agents inside a ticket.

Can AI answer tickets from a knowledge base?

Yes, if the articles are accurate. In WeldDesk, WeldAgent can answer common questions from the knowledge base and hand anything uncertain to a person with the full conversation. The answers are only as good as the articles behind them.

See it all work together

WeldSuite brings CRM, helpdesk, accounting, mail, projects and more into one connected platform. Change something once and it shows up everywhere.

Keep reading

Get started today

in minutes