Knowledge base article template

# How to [do the specific task]

[One or two sentences: what this article helps the reader do and when they'd need it.]

**Before you start**
- [Prerequisite — e.g. an account on the [plan] plan]
- [Prerequisite — e.g. admin access to [area]]

**Steps**
1. Go to [where] and [first action].
2. [Next action]. [screenshot: what the reader should see]
3. [Next action].
4. [Final action] to [confirm it worked].

**If it doesn't work**
[The one thing that most often goes wrong, and how to fix it.]

**Related articles**
- [Adjacent how-to]
- [The concept behind this]

*Summary: [the task] takes [N] steps — [the gist in one line].*

# [Symptom, in the reader's words — e.g. "Emails aren't sending"]

[One or two sentences: what this article covers and who runs into it.]

**Quick checks first**
- [The fastest thing to check — e.g. is [setting] turned on?]
- [Second quick check]

**Cause 1 — [most common cause]**
1. [Step to confirm this is the cause.]
2. [Step to fix it.]

**Cause 2 — [next cause]**
1. [Step to confirm.]
2. [Step to fix.]

**Still not working?**
[What to gather and how to reach support — e.g. "Send us [details] at [link]".]

**Related articles**
- [The how-to for the working flow]
- [A related error]

*Summary: [symptom] is usually [most common cause] — [one-line fix].*

# Getting started with [product or feature]

[One or two sentences: what the reader will be able to do by the end.]

**What you'll need**
- [Requirement]
- [Requirement]

**Set up in [N] steps**
1. [Create / connect / turn on the first thing].
2. [The next setup step].
3. [The step that produces a first visible result].

**You're set up — what next**
[The first useful thing to do now that setup is done, with a link.]

**Related articles**
- [The next feature to explore]
- [Common first-week questions]

*Summary: you can be up and running in about [time] — [the gist].*

# What is [concept]?

[Concept] is [a plain one-sentence definition anyone could understand].

**Why it matters**
[Two or three sentences: what it lets the reader do, or the problem it solves.]

**When it applies**
[The situations where this concept comes up for the reader.]

**How it works**
[Explain in 2–3 short sections or a simple example. Keep it concrete — show one real case rather than every possibility.]

**Related articles**
- [The how-to that uses this concept]
- [A related concept]

*Summary: [concept] is [the one-line takeaway].*

# [Topic]: frequently asked questions

[One sentence introducing the topic these questions cover.]

**[The most common question, in the reader's words]?**
[A direct answer that leads with yes, no, or the key fact, then one line of context.]

**[Next question]?**
[Direct answer.]

**[Next question]?**
[Direct answer.]

**[Next question]?**
[Direct answer.]

**Related articles**
- [The full how-to for this topic]
- [A related FAQ]

*Summary: [the single most important thing to know about this topic].*

# [What changed — e.g. "You can now [do the new thing]"]

[One line: what's new and who it affects.]

**What's new**
[Two or three sentences on the change and what it lets the reader do.]

**Why it matters**
[The problem this solves or the time it saves.]

**What you need to do**
[Any action required — or "Nothing, it's on by default." Link the full how-to.]

**Related articles**
- [How to use [feature]]
- [What's changed previously]

*Summary: [feature] is live — [the one-line benefit].*