Skip to main content
Guide

What is a knowledge base?

The term covers several quite different things. Getting the distinction right before you choose a tool saves a migration later.

What is a knowledge base?

A knowledge base is a structured, searchable library of articles that answer the questions a defined audience keeps asking. It differs from a document repository in being organised for retrieval rather than storage, and from a wiki in that content has named owners, review cycles and a deliberate publishing step. The two main kinds are external - public, customer-facing, measured in deflected support contacts - and internal, which sits behind authentication and serves employees.

  • Organised for finding an answer, not for storing a file.
  • Content is owned, reviewed on a cycle, and published deliberately.
  • External knowledge bases serve customers and need SEO.
  • Internal knowledge bases serve employees and need permissions.
  • Success is measured in questions answered without a human.

The phrase covers everything from a public help centre to an internal runbook library. They share a content model and almost nothing else - so the first useful step is deciding which one you are actually building.

A definition worth using

A knowledge base is a structured, searchable collection of articles that answers the recurring questions of a specific audience. Three words in that sentence carry the weight. Structured, because a pile of documents is not a knowledge base. Searchable, because content nobody can find has no value. And recurring, because the return comes from answering the same question a thousand times instead of once.

The distinction that matters most in practice is not technical. It is that a knowledge base has readers who are not its authors. That single fact is what forces ownership, review cycles, approval before publishing and a real search experience - none of which a personal notes repository ever needs.

The two main types

Almost every knowledge base is one of two kinds, and confusing them is the most common early mistake. They share a content model and share almost nothing else.

An external knowledge base serves customers. It is public, needs to rank in search engines because that is how most people arrive, is written in plain language for someone who does not know your internal vocabulary, and is measured by whether support contacts fall.

An internal knowledge base serves employees. It sits behind authentication, needs permissions because not everyone should see everything, can assume shared vocabulary, and is measured by whether people stop asking each other the same questions.

  • External: public, SEO matters, plain language, measured in ticket deflection.
  • Internal: authenticated, permissions matter, shared vocabulary, measured in interruptions avoided.
  • Partner or customer-only: a hybrid - authenticated, but the readers are not colleagues.
  • A single platform can host all three, but the content should not be shared between them without thought.

What every knowledge base needs

Regardless of type, a knowledge base that works has the same five components. Tools differ in how well they do each, but a knowledge base missing any of them tends to fail in a predictable way.

  • Structure: categories and a hierarchy that match how readers think, not how your org chart is drawn.
  • Search: the primary interface for most readers. If search is poor, structure barely matters.
  • Ownership: a named person responsible for each article's accuracy. Unowned content decays silently.
  • A review cycle: a date by which each article must be re-confirmed. Without one, decay is invisible until a customer finds it.
  • Measurement: at minimum, what people searched for and did not find. This is the input to everything you write next.

How it differs from a wiki

Wikis and knowledge bases look similar and are optimised for opposite things. A wiki is optimised for capture: anyone can create a page, editing is frictionless, and the value is in getting something written down before it is lost. A knowledge base is optimised for retrieval: a reader needs to find a correct answer and be able to trust it.

That difference produces every other difference. Wikis do not usually have approval steps, because an approval step slows capture. Knowledge bases do, because a wrong published answer is expensive. Wikis rarely have reader-facing versioning; knowledge bases documenting a product need it. Wikis rarely need SEO; external knowledge bases live or die by it.

The practical consequence is that most organisations need both, split by audience rather than by team. Project pages, meeting notes and thinking-in-progress belong in a wiki. Anything with external readers or a review cycle belongs in a knowledge base.

How it differs from a CMS and a helpdesk

A content management system publishes marketing pages. It has no concept of an article owner, a review cycle, a version of a product, or a search-gap report. Teams that publish documentation from their marketing CMS usually find the maintenance model, not the publishing, is what breaks.

A helpdesk manages conversations - tickets, queues, agents, SLAs. Some helpdesks include a knowledge base, which is convenient and tightly integrated, but scopes the documentation to support use cases and ties it to that vendor. If your documentation also serves partners, developers or internal staff, that coupling becomes a constraint.

Where AI changes things, and where it does not

Retrieval has genuinely changed. A reader can now ask a full question in their own words and get a written answer rather than a list of ten articles to read. For a customer with a specific problem that is a large improvement, and it makes the quality of your search experience less dependent on how well readers guess your keywords.

What has not changed is that the answer has to exist. An AI layer over a knowledge base with gaps produces confident non-answers, or worse, plausible inventions. The useful thing AI adds is not just the answering - it is the record of every question it could not answer, which is the most honest content backlog a documentation team has ever had access to.

Starting one that works

The most common failure mode is starting too big. A team decides to document everything, writes two hundred articles over three months, and then cannot keep any of them current.

The alternative that works is narrow and maintained. Export the last quarter of support tickets, group them by reason, and write the top thirty as articles. Give each one an owner and a review date. Link them from where the question actually arises - the error message, the billing page, the support form. Then read the failed-search report every month and write the top five gaps.

Thirty accurate articles that are linked from the right places will outperform three hundred that nobody maintains. You can always add more; you cannot easily rescue a library that has lost the reader's trust.

  • Start with your top thirty support drivers, ranked by volume.
  • Give every article an owner and a review date on day one.
  • Link from where the question arises, not just from the footer.
  • Read the failed-search report monthly and write the top five gaps.
  • Measure against your own baseline, not a vendor benchmark.
Frequently asked

Questions people ask before they start

A structured, searchable collection of articles that answer the questions a specific audience keeps asking. Unlike a folder of documents, it is organised for finding rather than for storing, and unlike a wiki it is owned, reviewed and published deliberately.

The audience, and therefore almost everything else. An external knowledge base serves customers: it is public, needs SEO, and success is measured in deflected tickets. An internal one serves employees: it sits behind sign-in, needs permissions, and success is measured in questions not asked.

No. A wiki optimises for anyone editing anything - it is a collaboration surface. A knowledge base optimises for a reader finding a trustworthy answer, which requires ownership, review cycles and publishing control.

Not to start. A small team can run a useful knowledge base out of a wiki or a shared document. You need a dedicated tool when you need versioning, approval before publishing, public SEO, multiple languages, or separate audiences.

Fewer than most people expect. Thirty articles covering your most common questions will outperform three hundred covering everything, because the thirty can be kept accurate.

Start with thirty articles. See what the search report tells you.

Start free for 14 days. No credit card, no setup fee, and your content is yours to export at any time.

Questions first? Email sales@thedocs.in or call +91 8585953085.