The Ultimate Knowledge Base Article Template With Examples

In this guide to the ultimate knowledge base article template I’ll show you how to create a profit-boosting, customer-retaining, support-request-reducing, overall awesome knowledge base. Read on to find out how…
You spend an enormous amount of time and energy trying to acquire new customers. But do you put the same effort into retaining the customers you already have?
Creating a killer knowledge base might not be sexy, but it will go a long way towards helping your paying customers get the most from your product. And the more value you can give your customers, the more likely they’ll become return customers.
In This Guide
- Knowledge Base Article Template
- 1. Choose a Title Your Customers Can Find
- 2. Start With the Problem
- 3. Include a Table of Contents for Long Articles
- 4. Write the Instructions – One Step, One Point
- 5. Break Up Content With Headings
- 6. Use Proper Formatting for Asides and Notes
- Link Your Knowledge Base Articles Together
- 7. Standardize Your Knowledge Base Article Template
- Tips for Writing Knowledge Base Articles
- Knowledge Base Style Guide: Useful Tips and How To Create

We rigorously test and research every product that we recommend through HeroThemes. Our review process. We may also earn a commission if you make a purchase through our links.

Build a knowledge base and help your customers help themselves.
Get the ThemeKnowledge Base Article Template

1. Choose a Title Your Customers Can Find
Let’s start at the beginning – your title. A thought-out title is essential because it’s how customers will actually find the answers to their problems.
The fact of the matter is this:
If your customers don’t know the knowledge base article can solve their problem, it doesn’t matter one lick how good the rest of the article is!
So make your title count. Avoid jargon. Explain the problem in simple English using the same terminology that you use in your interface.
Look how MailChimp’s article titles are all simple and tied to interface items (e.g. “Email Beamer”):

Getting the title right is vital for search – most of the traffic to an article comes from a search – either from a Search Engine such as Google or your own site search. Ensure customers searching for help can quickly find relevant results rather than having to trawl through your entire knowledge base.
2. Start With the Problem
At the top of your article, start by succinctly discussing the actual problem that you’ll be solving in the article. This lets readers know they’re at the right place to find answers and properly sets their expectations for what they’ll get from the article.
Look how Loco2, a train booking service, explains exactly what readers can expect in each article:

For specific topics, be specific. For example, if your article is about solving an error message, discuss the error message in the first paragraph. Quickly explain why your customer is receiving the error message before you jump into solving it.
Look how Yoast quickly explains exactly why an error is occurring:

3. Include a Table of Contents for Long Articles
If your article is especially long, it’s a good idea to include a table of contents so that readers can skip to the exact section that they need. Whenever possible, it might even be a better idea to break up the article into separate, shorter articles.
But if long content is unavoidable, slap a table of contents on it. Check out how MailChimp does it, even on their shorter articles:

And if you’ve ever used the HeroThemes knowledge base, you might’ve noticed that we do something similar with our Table of Contents widget:

4. Write the Instructions – One Step, One Point
If you’re familiar with your product, writing instructions can be surprisingly difficult. You know the ins and outs, so it’s easy to forget that your readers lack the same level of expertise. Don’t do that.
Keep your instructions simple. One step should only cover one point. What do I mean by that?
Look at how Dropbox writes instructions:

Isn’t that simpler than writing: “1. Sign in to Dropbox, click on your name and choose Settings”? I think so.
Separating your instructions into clear points makes it easier for your readers to follow along.
Similarly, if you’re writing FAQs instead of instructions, you should keep each question and answer to a specific topic.
5. Break Up Content With Headings
Use intelligent headings to break up your content into easily digestible chunks. If one article requires readers to complete two different sets of actions, it’s a good idea to stick them underneath separate headings.
For example, look how Canva uses headings to break up different sets of instructions in the same article:

6. Use Proper Formatting for Asides and Notes
Sometimes you’ll need to add more information to your instructions or FAQs. That’s fine. It’s unavoidable. But when you do add extra information, make sure you format it so readers know it’s an aside.
For example, look how we use Heroic Shortcodes to style asides in our KnowAll knowledge base theme:

Readers can quickly distinguish between instructions and the additional information contained in asides.
Similarly, Asana uses bullet point icons and borders to differentiate their “Asana Tips” from regular instructions:

Properly formatting the different types of information in your knowledge base articles goes a long way towards enhancing your readers’ comprehension.
Link Your Knowledge Base Articles Together
Here’s what the best knowledge bases do:
They don’t just solve the current problem a customer is facing. They also solve the next problem before the customer even knows they need help.
What do I mean? Look how Asana ends almost every article in their knowledge base:

If you click through to that article and scroll to the bottom, you’ll find another link:

Asana knows that if they can push their customers to get the most value from Asana, then those customers will be more likely to stick around (and keep paying!). To accomplish that, they use the conclusion of their knowledge base articles to drive customers to learn even more about their product.
For instance, what if a customer didn’t know it was possible to invite teammates
to Asana? Without the link at the conclusion of the article, they might never know about that essential function in Asana.
So, use your knowledge base articles to drive engagement and retention. Push people towards the next logical step so that you ensure your customers get the most value from your product.
7. Standardize Your Knowledge Base Article Template
Last but not least, you need to put these principles into developing a standardized template for your articles. Using the same template over and over allows your customers to develop cognitive fluency.
Essentially, it makes it easier for them to navigate your knowledge base because they’re already familiar with how things work. They know that bullet icon means it’s an aside, while that other bullet icon means it’s an essential instruction point.
Tips for Writing Knowledge Base Articles
Ok – you know the template. But how about actually writing your knowledge base articles? Here are a few tips to start you off on the right track:
- Show Don’t Tell – “A picture is worth a thousand words” might be a cliche at this point, but it is true for your knowledge base. Whenever possible, add screenshots, animated GIFs, or even videos to make it easier for readers to follow along.
- Start with the Easiest First – If readers need to complete multiple steps, always start with the easiest step first if possible. This allows readers to get at least one accomplishment under their belt before they move to the hard stuff.
- Use the Right Tone – Be straightforward and avoid jargon whenever possible. Remember, your main goal is to communicate information. And always consider your readers’ moods – if you’re writing an article on a frustrating error message, you probably shouldn’t be cracking jokes.
- Avoid the Curse of Knowledge – I touched on this above – but always remember that your readers don’t have the same depth of knowledge as you do. Try to put yourself in a beginner’s shoes when writing knowledge base articles (You may want to check out some examples of effective knowledge base articles).
Knowledge Base Style Guide: Useful Tips and How To Create
Do Companies Actually Do This? Is a Knowledge Base Style Guide a Real Thing?
Ok, I’m going to tell you how to create your style guide in a second. But first, I want to lead with some examples of companies who are actually doing this. This accomplishes two goals:
- It shows you that I’m not just making things up to create more blog content 😉
- It gives you a real-life example you can pull from for your own style guide.
Let’s look at Mozilla knowledge base style guide first.
Mozilla has a whole entry on the style guide for their knowledge base. Because Mozilla is open source, it’s especially essential for them to have a style guide to, in their own words, “make the Firefox support Knowledge Base consistent, resulting in a knowledge base, that is easy to read and contribute to.”. Easy to read? That sounds like a good goal for your knowledge base, right?

The guide goes deep, taking you through everything from capitalization, to whitespace, to serial commas.
MailChimp’s Voice & Tone style guide is another worthwhile read. While it’s not 100% focused on knowledge bases, it does have a number of entries for both knowledge base and tutorial content:

Whereas Mozilla’s style guide is more focused on style and formatting, MailChimp opts to focus more on, well, voice and tone, than nitty-gritty formatting.
I tossed a couple examples at you, but I have yet to give you a process for actually creating your own knowledge base style guide. So let’s fix that!
1. Use a Consistent Person
Have you ever read an article where the author switched back and forth between “I” and “We”? I have, and we can tell you that it’s exceedingly confusing.
So, if you’re going to use the first person – pick one and be consistent about it. Even if you’re solo, you can still opt to use “we”. Up to you! Just use the same one.
Additionally, you don’t even need to use first person. You can opt to eschew “I” and “we” altogether.
There’s not really a right answer here – it’s just about consistency.
2. Standardize Your Formatting
You know that good knowledge bases use lots of instructions with small steps. And those instructions will, at some point, include language like:
Click on File.
So – is it:
- Click on File
- Click on “File”
- Click on File
And when you actually write your lists, is it:
- Step 1: Click this
- Step 2: Click that
Or is it like this:
- Click this
- Click that
Again – you can pick the one you like best – but whichever one you choose, use it consistently across your whole knowledge base.
There are other formatting choices you need to make as well – the Mozilla style guide gives you a good idea of everything to cover, but here are some starter ideas:
- Heading capitalization – will you use sentence case or Title Case?
- Numbers – is it 10 or ten?
- Abbreviations – don’t or do not?
- Acronyms – CDN or content delivery network?
If you’re using one of our knowledge base WordPress themes or plugins, our built-in shortcodes and formatting options can help you stay consistent when it comes to formatting
3. Get the Voice Right
Finally, you need to go beyond formatting and standardize your voice.
Are you your customer’s friend? Or are you Spock from Star Trek, dispassionately dispensing cold hard wisdom?
Within reason, either is fine. As long as it’s consistent.
In general, you should make sure to follow MailChimp’s knowledge base guide tips. I suggest them not only because MailChimp actually published their guide, but also because I think MailChimp has one of the best knowledge bases out there.
Their advice is this:
- Always make your first priority to answer questions and inform your readers. Jokes are ok sometimes, but not if they distract from that essential goal.
- Avoid speaking like a marketer – you’re just trying to help.
Wrapping Things Up
Creating templates for knowledge base articles will pay off in the form of a more easily comprehensible knowledge base.
Remember to follow this template:
- Choose an easy-to-find title
- Describe the problem and set expectations
- Keep your instructions and FAQs to specific points
- Use proper formatting for the table of contents, headers, and asides
- Push readers towards other knowledge base articles that help them get more value from your product
And then remember to use that same template for all of your knowledge base articles!
Need suggestions for your own knowledge base? Leave a comment below and I’ll do my best to help out!
Thank you, this was very useful
Well done and very helpful. The guidelines applied are generally good technical writing practice. The pictures/images, as you say “… are worth a thousand words.” Thank you.
Thank you! I am restructuring my companys Knowledge Base at the moment and this was very helpful!