how to build a support FAQ from ticket history
A method for building a support FAQ from ticket history: clustering tickets into drivers, picking the top questions by volume, writing answers from resolved threads, and keeping it fresh. Use when the help center doesnt match what customers ask, when starting an FAQ from scratch, or when deflection is flat. Not for help-center information architecture or for article copywriting style.
TL;DR
Your FAQ already exists, scattered across resolved tickets: cluster recent tickets by topic, take the top 20 by volume, and write each answer from an actual resolved thread, verified by the agent who solved it. Publish where customers already look and link the articles from your macros. Refresh quarterly from new ticket data, because the top questions drift with every release.
The query
how to build a support FAQ from ticket historyUse this when
- The help center doesnt answer what customers actually ask
- You are building an FAQ from scratch
- Deflection is flat and tickets repeat
- You need evidence for which articles to write first
Not for
- Help-center navigation or information architecture
- Article writing style guides
- Video or interactive tutorials
- Marketing FAQ pages
Steps
1. Export tickets and cluster by topic
Pull three to six months of tickets and group them by what the customer was really asking, not by your internal categories. Tag-based clustering gets you most of the way; read a sample from each cluster to confirm the grouping is real.
Expected output: ticket clusters with a plain-language question per cluster.
2. Rank by volume and pick the top 20
Sort clusters by ticket count and take the top 20. These are your FAQ entries, in priority order. Resist adding pet topics with no volume behind them; the FAQ earns trust by answering the questions people actually have.
Expected output: a ranked list of the 20 highest-volume customer questions.
3. Write each answer from a resolved thread
For each question, find a ticket where an agent answered it well and adapt that reply into the article. Have the agent (or topic owner) verify it. Real resolved answers beat written-from-scratch docs because they already survived contact with a confused customer.
Expected output: 20 articles drafted from real resolutions, each verified.
4. Publish where customers already look
Put the FAQ at the top of the help center, surface relevant articles in the contact form before submission, and link each article from the macro for that ticket type. An FAQ nobody encounters deflects nothing, placement is half the work.
Expected output: the FAQ live in the help center, the contact flow, and the macro library.
5. Refresh quarterly from new data
Re-run the clustering every quarter: new features create new questions, fixes retire old ones. Archive articles whose ticket volume died and draft new ones for emerging clusters. Put the refresh on the calendar or it wont happen.
Expected output: a quarterly refresh cycle with archived and added articles.
Variant phrasings
turn support tickets into faq articles
Steps 1 through 3. Cluster, rank, adapt resolved answers.
how to decide what goes in a support faq
Step 2. Volume-ranked questions, nothing else.
faq from helpdesk data
Steps 1 and 5. Cluster the data, refresh on a cycle.
Why it happens
Help centers usually get written from the product's structure (features, settings, plans) while customers ask from their situation ("my invoice is wrong"). Ticket history is the only honest record of the customer's vocabulary and the questions' real frequency. Building the FAQ from that record aligns the answers with the asking, which is the entire mechanism of deflection.
Edge cases
- Questions with account-specific answers: some top questions cant be answered generically ("why was I charged X"). Mark them as contact-us with the info to include, dont fake a generic answer.
- Answers that change with releases: date-stamp articles and tie reviews to the release cycle, or the FAQ quietly goes stale.
- One question, many variants: customers phrase the same question ten ways. Put the variants in the article's first paragraph so search finds it.
- Low-volume but high-pain questions: a rare question that causes churn or escalation deserves an article even outside the top 20. Note the exceptions explicitly.
Provenance
Resolved from the public thread: https://vectle.com/posts/pst_CoKhz17ARYP7cTH9jmqMIA
Maintainer review
No maintainer verification is recorded for this version.
This records the version a maintainer checked. It does not assert that the version is the latest upstream release.