GLOSSARY
What is a knowledge base? Kinds and examples
A knowledge base is one searchable place for the answers to your customers’ questions. What goes in one, how tools organise it, and how to start small.
A knowledge base is a collection of short articles that answer the questions people ask about a product, kept in one place where they can search it. Each article covers one question or one task, such as how to export your data or what happens when a payment fails. A knowledge base for customers is usually published as a help centre on your own site, at an address like help.yourcompany.com. A team can keep a private one for itself too.
For a founder without a support team, a knowledge base is how you stop typing the same reply every week. Write the answer once, and every customer who finds it is one email you don’t have to send. Deacon is an AI customer support agent that answers your customers from your own docs, in a chat on your site, in seconds. It has a free plan.
What goes in a knowledge base
Most knowledge bases for a software product hold the same six kinds of article. Here is what each one answers, with a title it might carry.
| Kind of article | What it answers | Example title |
|---|---|---|
| Getting started | The first steps after signing up | How do I set up my first project? |
| How-to | One task, step by step | How do I invite a teammate? |
| Troubleshooting | A symptom or an error message, and the fix | Why does my import say “Invalid date”? |
| Billing and account | Plans, invoices, cards and cancelling | Where do I find my invoices? |
| Policy | A rule, stated exactly as you mean it | Can I get a refund on a yearly plan? |
| Reference | Facts to look up, such as limits and settings | Which file types can I upload? |
Getting started
- What it answers
- The first steps after signing up
- Example title
- How do I set up my first project?
How-to
- What it answers
- One task, step by step
- Example title
- How do I invite a teammate?
Troubleshooting
- What it answers
- A symptom or an error message, and the fix
- Example title
- Why does my import say “Invalid date”?
Billing and account
- What it answers
- Plans, invoices, cards and cancelling
- Example title
- Where do I find my invoices?
Policy
- What it answers
- A rule, stated exactly as you mean it
- Example title
- Can I get a refund on a yearly plan?
Reference
- What it answers
- Facts to look up, such as limits and settings
- Example title
- Which file types can I upload?
Three kinds of knowledge base
The phrase is used for three different things, and search results mix them up.
- An external knowledge base is written for your customers and published where anyone can read it. It’s the kind this entry is mostly about.
- An internal knowledge base is written for your own team, such as how you deploy or how you handle a refund request. It usually lives in a wiki such as Notion or Confluence, behind a sign-in.
- An AI knowledge base is the content an AI agent answers from, cut into passages it can search. Your external knowledge base is often the biggest part of it, next to your website, your files and answers you’ve written.
How knowledge base tools organise articles
Most knowledge base software sorts articles into two or three levels, and each tool names the levels differently. These are the defaults in three well-known tools, from their own guides, read on 7 October 2026.
| Tool | Top level | Middle level | Worth knowing |
|---|---|---|---|
| Zendesk | Categories | Sections, which can hold subsections | With only one category, customers don’t see it and see its sections instead |
| Help Scout Docs | Collections | Categories | An article can sit in several categories, but never in more than one collection |
| Freshdesk | Categories | Folders | Folders inside folders, up to five levels, need the Enterprise plan. Other plans stop at category, folder and article |
Zendesk
- Top level
- Categories
- Middle level
- Sections, which can hold subsections
- Worth knowing
- With only one category, customers don’t see it and see its sections instead
Help Scout Docs
- Top level
- Collections
- Middle level
- Categories
- Worth knowing
- An article can sit in several categories, but never in more than one collection
Freshdesk
- Top level
- Categories
- Middle level
- Folders
- Worth knowing
- Folders inside folders, up to five levels, need the Enterprise plan. Other plans stop at category, folder and article
In all three, the articles sit at the bottom. Freshdesk keeps its knowledge base under a menu called Solutions, which is why its help articles have /solutions/ in their addresses.
For a small product, fewer levels work better. With 20 articles, one row of five or six headings, such as Getting started, Billing and Integrations, lets a customer see everything at a glance. Add a second level when one heading holds more articles than fit on a screen.
Knowledge base vs help centre, FAQ page, documentation and wiki
These words get swapped for each other. This is how they usually differ.
| Term | What it is | Who it’s for |
|---|---|---|
| Knowledge base | The articles themselves, one question or task each | Customers, or your team for an internal one |
| Help centre | The public website a knowledge base is published as, often with a search box and a contact form | Customers |
| FAQ page | Short answers gathered on a single page | New customers with the same ten questions |
| Documentation | A complete reference for a product or an API, often organised like a manual | Developers and power users |
| Wiki | Pages anyone on the team can edit | Your own team |
Knowledge base
- What it is
- The articles themselves, one question or task each
- Who it’s for
- Customers, or your team for an internal one
Help centre
- What it is
- The public website a knowledge base is published as, often with a search box and a contact form
- Who it’s for
- Customers
FAQ page
- What it is
- Short answers gathered on a single page
- Who it’s for
- New customers with the same ten questions
Documentation
- What it is
- A complete reference for a product or an API, often organised like a manual
- Who it’s for
- Developers and power users
Wiki
- What it is
- Pages anyone on the team can edit
- Who it’s for
- Your own team
A small SaaS often starts with an FAQ page and grows it into a knowledge base once the answers need steps and screenshots.
How to tell whether a knowledge base is working
The most useful measure for a small team is coverage, the share of customer questions that an article you’ve already published answers.
Knowledge base coverage = questions an existing article answers ÷ all questions customers asked × 100
Take your last 50 support emails and chats. If an article already answers 30 of them, your coverage is 30 ÷ 50 × 100, or 60%. The other 20 are the next articles to write.
The 30 matter too, because each one is a customer who wrote in although the answer was already published. When that count is high, people can’t find your articles. A clearer title, the customer’s own words in the first line or a link from the screen where they get stuck will do more than another new article.
Coverage sits beside deflection rate, the share of questions answered before they reach you, and both are part of customer self-service.
Starting a knowledge base without a support team
You don’t need knowledge base software on day one. A few pages on your own site are enough to begin, and you can move them into a tool later.
- List every question customers asked you this month, in their words.
- Write one article for each question that came up twice, and title it with the question.
- Answer in the first line, then give any steps as a numbered list.
- Link each article from the place in your product where people get stuck.
- Write a new article the second time a new question arrives.
How to write knowledge base articles has six before-and-after rewrites to copy. When you want a help centre of your own, the best knowledge base software compares eight tools for small teams.
A knowledge base your customers can ask, with Deacon
A knowledge base only helps the customers who find the right article. Deacon lets them ask instead. It reads your knowledge base and the rest of your content, then answers your customers in a chat on your site, in seconds, at any hour and in the language they write in.
It learns from pages on your website, uploaded files, text you paste in and answers you write yourself. Files can be PDF, Word (.docx), text, Markdown, CSV or HTML, up to 10 MB each. A PDF of up to 200 pages is read in full, each page as an image, so a scanned manual works too, and a longer one is turned away with a note to split it into parts. You don’t need a help centre first. When you sign up, Deacon reads your home page and up to four main pages, such as pricing and help, and can answer within a minute or so. Knowledge base chatbot shows the whole process.
It fills the gaps in your knowledge base as they show up. When your content doesn’t cover a question, Deacon says it doesn’t know instead of guessing and asks for the visitor’s email, so you can reply yourself. The question then waits in Conversations with an Answer this button. Write the answer once and it becomes part of what Deacon knows, so Deacon can give it to the next customer who asks, and Save & check shows you the reply Deacon now gives. That’s your coverage going up without a new article.
It also tells you which article to write next. Topics group similar questions and count the people who asked, so you fill the gap with the most people behind it first.
Knowledge on each plan is counted by the text Deacon takes from your content, not by file size. The free plan holds 1 MB, which is about 67 pages of docs. Starter holds 15 MB, about 1,000 pages, and Growth holds 50 MB, about 3,330. Every feature is on every plan, and the free plan needs no card and has no end date.
Try it on your own documentation
Add your help pages, ask it the question you know your docs cannot answer, and watch it say so.
Free plan, no card.