How to Write Help Articles: A Seven-Step Method, Five Templates and the Mistakes That Make Customers Give Up
How to write help articles is mostly a question of order: start from the question a customer really typed, give the answer in the first line, then add steps, and stop. This guide gives you a seven-step method, five copy-ready templates and a list of mistakes to avoid, with made-up examples clearly labelled as illustrative.
⚡ In short
- One article answers one question, and its title uses the customer’s own words.
- Put the answer in the first sentence. Steps, details and exceptions come after.
- Short sentences, numbered steps and a clear last line. Cut anything that does not help the reader finish.
- Check each article with a real person, then watch the helpful and not-helpful votes.
- Start with the five questions that fill your inbox. Ten good articles beat fifty thin ones.

Start here
Find the questions before you write a word
Most weak help centers fail before the first sentence, because they are built around what the business wants to say instead of what customers ask. Fix that first.
Open your inbox, your saved replies and your WhatsApp or email and list the questions that appear more than twice in a month. You will usually find that five to ten questions make up most of the volume: delivery, payment, returns, booking, passwords, pricing, and where to find something.
Where to look
- Your chat history, searching for words like “how”, “where”, “can I” and “when”.
- Your saved replies. If you already type an answer often, it is an article waiting to happen.
- The on-site searches and chat questions shown in LiveChatBot Reports, which list what visitors ask about.
- Your own team: ask the person who answers the phone.
Write each question exactly as a customer would. “Where is my parcel?” is better than “Order status information”.
The method
How to write help articles in seven steps
Here is the method in order. Follow it for each article and you will get consistent results.
- Name one question. One article, one problem. If you need the word “and” in the title, split it into two.
- Use the customer’s words as the title. Say “How do I change my delivery address?” not “Address modification”.
- Answer in the first sentence. If the answer is yes, no or a number, say it straight away.
- Add numbered steps. Use them for anything the reader must do. Start each step with a verb: Open, Tap, Choose.
- Cover the exception. Add one short note for the case that breaks the rule, such as “orders after 6 pm ship next day”.
- End with a next move. A related article, or “Still stuck? Start a chat.”
- Test it on someone new. Ask a person who has never seen it to follow the steps. Fix where they hesitate.
How long should it be?
As long as the question needs, no longer. Many good articles are between 80 and 250 words. A complex setup guide may be longer, but break it into headed sections so readers can jump.
Templates
Five article shapes you can copy
Pick the shape that matches the question, then fill in your own facts.
Worked example
A worked example: from a messy chat to a finished article
Here is an illustrative example. A small online shop (made up) notices this chat message three times in one week: “my order not came, what to do”. The owner decides to turn it into an article.
Step by step
- Question and title: “Where is my order?” It is short, and it is what customers say.
- First sentence: “Orders usually arrive 3 to 5 working days after dispatch.”
- Steps: 1. Open the tracking page. 2. Enter your order number. 3. Check the status shown.
- Exception: “Remote pin codes can take up to 8 working days.”
- Next move: “Still not here after 8 days? Start a chat with your order number.”
The whole article is about 90 words. It took ten minutes to write and removes a question the owner was typing out by hand every day. Repeat this for your next four questions and you have a working help center.
Check it with a stranger
Ask someone outside your team to find the article by searching for “order not came”. If they cannot find it, add that wording to the title or the first line. That is how to write help articles that match real searches, not your own internal names.
Wording
Write in plain words, with the answer up front
Readers scan. They look at the title, the first line and the numbered steps. If the answer is not in those three places, many will leave.
Rules that work for most small businesses
- Use short sentences. Aim for under 20 words each.
- Prefer common words. Say “use” instead of “utilise” and “start” instead of “initiate”.
- Keep one idea per paragraph, and break up anything longer than four lines.
- Write “you”, not “the customer”.
- Name buttons exactly as they appear on screen, in bold.
- Give real numbers: days, rupees, limits. Vague words like “soon” create more questions.
Write for people who read in more than one language
Many of your customers will read English as a second language, so avoid idioms and long compound sentences. If you serve several language groups, write a separate article for each language and name the titles clearly. Plain, literal wording also helps when someone pastes the article into a translator.
Structure
Organise articles into a few clear categories
Once you have ten or more articles, you need a simple structure. Two to six categories is plenty for a small business.
Name categories after what customers are trying to do, not after your departments. “Orders and delivery” is clearer than “Fulfilment”. “Payments and refunds” is clearer than “Finance”.
Order inside a category
Put the most-asked article first. When you see which ones get the most views, move them up. Keep titles parallel, such as a run of questions that all start with “How do I” or “What is”, so the list looks tidy.
Do not duplicate
If two articles answer the same question, merge them. Customers who find two slightly different answers will assume one is wrong, and your bot will also have two sources to choose from.
Mistakes
Mistakes that make customers give up
The same errors appear in most help centers. Check your articles for these.
Using LiveChatBot
Publish, measure and reuse your articles in LiveChatBot
You can do all of this in any editor, but there is a practical benefit in writing inside your chat tool. In the Help center tab of LiveChatBot you add articles and categories, publish them to a public page at livechatbot.in/help/ followed by your widget key, and show search plus featured and popular articles on the widget home screen. The full feature is described on the help center software page.
What happens after you publish
- Visitors vote each article helpful or not helpful.
- Reports list the articles that need work, ranked by “not helpful” votes.
- Published articles also feed the AI Agent and the free keyword bot as answers, so one article works in three places.
For the AI side, read how to train your AI chatbot. For the questions articles cannot settle, a support ticket keeps the follow-up organised. LiveChatBot is free to start with no per-seat charges; see pricing.
Review habit
A fifteen-minute review habit: how to write help articles that stay true
Writing is half the job. A calm weekly review does the other half.
Each week
- Open Reports and note the two articles with the most not-helpful votes.
- Read the chats from the same week and look for questions your articles did not answer.
- Fix or write up to three articles.
Each quarter
Re-read every article once. Check prices, hours, links, button names and screenshots. Delete anything no longer true. A short, correct help center is better than a long, half-wrong one.
Know when to stop
If an article keeps getting not-helpful votes after two rewrites, the question may need a conversation instead. Link it to a chat, a ticket or a phone number, and move on.
Frequently asked questions
How long should a help article be?
Long enough to answer the question. Many are 80 to 250 words. Longer setup guides should use headed sections.
How many articles do I need to start?
Five to ten, covering the questions that fill your inbox. Add more as new questions appear.
What is the best way to start learning how to write help articles?
Take your five most common customer questions, write each as a title in the customer’s words, and answer in the first sentence.
Should I use screenshots?
Only where they remove doubt. Name the buttons in text too, because screenshots go out of date when your screens change.
Can the same articles power a chatbot?
In LiveChatBot, yes. Published articles also feed the AI Agent and the free keyword bot as answers.
Keep reading
Related guides
Help Center Software: Public Help Articles, Search in the Chat Widget and a Bot That Answers From Them
FAQ Page vs Help Center: Which One Does Your Business Need, and When a Simple FAQ Is Enough
Write your first five articles today
Start free on livechatbot.in, add your articles and let your widget and bot use them.