All articles

Guides

How to write help articles an AI agent can use

Clear, specific articles make better answers. Here is the checklist our team uses when we help customers prepare their help center.

Theo Laurent

Head of Design

7 min read

Soft orange and pink gradient shape

Start with the question, not the feature

Customers ask about outcomes. Title articles the way people search: “How do I change my delivery address?” works better than “Address management”.

Keep one task per article. Long pages that cover five scenarios make it harder for any reader, person or agent, to find the one step that matters.

Write down the exceptions

Most escalations happen at the edges. If refunds work differently for gift cards or international orders, say so plainly in the article.

A quick checklist

One task per page. Clear eligibility rules. Exact steps. A note on what to do when the steps fail.

Give your team its mornings back

Start a 14-day trial with your own help center. Most teams see their first resolved ticket in under an hour.

Create a free website with Framer, the website builder loved by startups, designers and agencies.