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.

7steps in the method
5copy-ready templates
1question per article
0extra tools needed

⚡ 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.
How to write help articles in LiveChatBot: the chat widget on an online store answering a delivery question
How it looks in LiveChatBot: the chat widget on an online store answering a delivery question.

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.

  1. Name one question. One article, one problem. If you need the word “and” in the title, split it into two.
  2. Use the customer’s words as the title. Say “How do I change my delivery address?” not “Address modification”.
  3. Answer in the first sentence. If the answer is yes, no or a number, say it straight away.
  4. Add numbered steps. Use them for anything the reader must do. Start each step with a verb: Open, Tap, Choose.
  5. Cover the exception. Add one short note for the case that breaks the rule, such as “orders after 6 pm ship next day”.
  6. End with a next move. A related article, or “Still stuck? Start a chat.”
  7. 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.

Title: What is your refund policy?
Answer: You can return most items within [7] days for a full refund.
Conditions: Items must be unused and in the original pack. [List any exclusions.]
How to start: 1. Open [page]. 2. Enter your order number. 3. Choose the item.
Still stuck? Start a chat and we will help.
Title: How do I [do the thing]?
Short answer: You can [do the thing] from [place] in about [time].
Before you start: You will need [item 1] and [item 2].
1. Open [screen]. 2. Tap [button]. 3. Choose [option]. 4. Confirm.
If it did not work: [most common reason and fix].
Title: Where is my order?
Answer: Orders usually arrive in [3 to 5] working days after dispatch.
To check: Open [tracking page] and enter your order number.
If it is late: Wait until [day 6], then start a chat with your order number.
Title: How much does [service] cost?
Answer: [Service] starts at ₹[amount]. The final price depends on [factor].
What is included: [list].
What costs extra: [list].
To get an exact price: Start a chat or send your requirements.
Title: [Problem] is not working. What can I try?
Quick fix: Try [simplest step] first.
If that fails: 1. [Step]. 2. [Step]. 3. [Step].
Still not working? Send a screenshot in chat so we can look.

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.

Titles
🚩 Hard to useAccount access: password management procedures
✅ Easier to useHow do I reset my password?
Openings
🚩 Hard to useWe understand how frustrating delays can be. Here at our company we pride ourselves on service…
✅ Easier to useOrders arrive in 3 to 5 working days. To check yours, open the tracking page.
Steps
🚩 Hard to useNavigate to the relevant section and make the appropriate changes.
✅ Easier to use1. Open Settings. 2. Tap Address. 3. Edit and Save.
Dead ends
🚩 Hard to useAn article that stops after the instructions.
✅ Easier to useA last line: Still stuck? Start a chat and mention this article.
Stale facts
🚩 Hard to useOld prices and old hours still sitting in a published article.
✅ Easier to useA weekly look at the articles with the most not-helpful votes.

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

  1. Open Reports and note the two articles with the most not-helpful votes.
  2. Read the chats from the same week and look for questions your articles did not answer.
  3. 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

Read the guide →

🧭

FAQ Page vs Help Center: Which One Does Your Business Need, and When a Simple FAQ Is Enough

Read the guide →

Write your first five articles today

Start free on livechatbot.in, add your articles and let your widget and bot use them.