Why most knowledge bases fail
The typical knowledge base failure pattern: a support lead gets asked to "set up a help centre." They write 20 articles in a week covering everything they think customers might ask. Traffic to the articles is near zero. Ticket volume doesn't drop. The articles go stale. Nobody updates them. The knowledge base becomes a ghost town.
The problem is starting from what you think customers want to know, rather than what they're actually asking.
Step 1: Mine your ticket history first
Before writing a single article, pull your last 90 days of support tickets and categorise them. You'll find that 20–30% of your tickets are about the same 5–8 questions. Those are your first articles.
Common top-5 patterns for Indian businesses:
- "How do I reset my password?"
- "Where is my order / when will it arrive?"
- "How do I get a refund?"
- "I can't log in / my account is locked"
- "How do I change my [address / phone number / plan]?"
Write these first. These are the articles that will immediately deflect tickets.
Step 2: Write for the customer, not the company
The single biggest knowledge base mistake: writing from the company's perspective. "Our refund policy entitles customers to..." vs "Here's how to get a refund."
Every article should:
- Have a title that is the exact question the customer is asking ("How do I cancel my subscription?")
- Answer the question in the first paragraph — don't make them scroll for the answer
- Use numbered steps for processes (not paragraphs)
- Include screenshots where a visual is clearer than words
- End with "Still need help? Contact us: [link]"
💡 Title test: Would a customer type your article title into Google or the search box? "Refund Policy" → No. "How do I get a refund?" → Yes. Use the second format.
Step 3: Organise by customer task, not company structure
Bad organisation (company-centric):
- Product Team → Features → Billing → Subscriptions → Cancellation
Good organisation (customer-centric):
- Getting Started · Account & Login · Orders & Delivery · Billing & Payments · Returns & Refunds · Technical Issues
The customer doesn't know or care about your internal team structure. They know what task they're trying to complete.
Manage support tickets and your knowledge base in one place
Resolvo links your KB articles directly to ticket responses. Free to start.
Try Resolvo Free →Step 4: Make it findable
A knowledge base is only as good as its search. Three things that make KB articles findable:
- Use the exact words customers use — if customers say "cancel" don't only write "terminate subscription." Include both.
- Add article tags/keywords — tag every article with the search terms customers would use to find it
- Surface it at the right moment — link to relevant articles in your email replies, your confirmation emails, and your website footer
Step 5: Connect KB to your helpdesk
The most powerful knowledge base integration: when an agent is writing a ticket reply, they see suggested KB articles based on the ticket content. One click inserts the article link into the reply. The agent doesn't have to remember every article — the system surfaces the right one.
Over time, you can see which articles are being linked most often in replies. Those are your high-value articles — make sure they're up to date and comprehensive.
Keeping it up to date (the part everyone skips)
A knowledge base that's 20% outdated is worse than no knowledge base — it frustrates customers who follow old instructions that no longer work.
Simple maintenance system:
- Every time a product feature changes, the PM adds "update KB article [X]" to the release ticket
- Monthly: one team member reviews the top 10 most-visited articles for accuracy
- Quarterly: archive any articles with zero views in 6 months
This takes 2 hours per month — a fraction of the time saved by the articles deflecting tickets.
Measuring success
Track two metrics:
- KB deflection rate — of customers who visit the KB, what % don't submit a ticket afterwards? Target: 60%+
- Article satisfaction — "Was this article helpful? Yes / No" at the bottom of each article. Anything below 70% Yes needs rewriting.
Reduce tickets by 30% with a great knowledge base
Resolvo's built-in KB connects directly to your helpdesk. Free to start.
Start Free →