RelayDocs

Knowledge base

Writing articles

Articles do two jobs: they fill your public help center, and they are the only source the bot answers from. Every good article is a question you never have to answer by hand again.

Create an article#

Go to Inbox → Knowledge base and click New article.

Titleup to 140 charactersrequired
Phrase it the way customers ask: “Reset your password”, not “Credential management”.
Categoryup to 60 charactersoptional
Groups articles in the help center, e.g. Account, Billing. Defaults to General.
Excerptup to 240 charactersoptional
A one-sentence answer. Shown in search results, and it’s what the bot quotes when AI answers are off.
Bodyup to 20,000 charactersoptional
The full answer, using the formatting below.
Publishedon / offoptional
Drafts are hidden from the help center and the bot.

The article’s URL is made from its title, for example /w/your-workspace/help/reset-your-password.

Renaming changes the URL

Changing an article’s title changes its URL. Links you’ve shared to the old URL will stop working, so prefer small title edits on popular articles.

Formatting#

Article bodies use a small, safe subset of Markdown. HTML is never rendered.

WriteTo get
## Didn't get the email?A section heading
- Check your spam folderA bullet (a * works too)
**Forgot password**Bold text
A blank lineA new paragraph
Example body
If you can't sign in, go to the sign-in page and click **Forgot password**.
We'll email you a reset link that's valid for 60 minutes.

## Didn't get the email?
- Check your spam or promotions folder.
- Make sure you're using the email you signed up with.

If you signed up with Google, use **Continue with Google** instead.

Writing for the bot#

Use your customers’ words#

The bot finds articles by matching words, with the title counting most. If customers say “invoice” and your article says “receipt”, mention both.

Answer in the first lines#

Put the direct answer in the excerpt and the first paragraph, and details after. The bot’s answers are short.

One question per article#

Several focused articles beat one long page: each gets a clear title, and the bot cites exactly the right one.

Be explicit about limits#

The bot never invents prices, timelines or refunds. If an answer depends on the plan, say so in the article, so the bot can too.

Find what to write next

Open Inbox → Bot handling and your handed-off conversations. Every question the bot couldn’t answer is a missing article.