What's Your Question?

10 Great Essay Writing Tips

writing knowledge articles

Knowing how to write a college essay is a useful skill for anyone who plans to go to college. Most colleges and universities ask you to submit a writing sample with your application. As a student, you’ll also write essays in your courses. Impress your professors with your knowledge and skill by using these great essay writing tips.

Prepare to Answer the Question

Most college essays ask you to answer a question or synthesize information you learned in class. Review notes you have from lectures, read the recommended texts and make sure you understand the topic. You should refer to these sources in your essay.

writing knowledge articles

Plan Your Essay

Many students see planning as a waste of time, but it actually saves you time. Take a few minutes to think about the topic and what you want to say about it. You can write an outline, draw a chart or use a graphic organizer to arrange your ideas. This gives you a chance to spot problems in your ideas before you spend time writing out the paragraphs.

Choose a Writing Method That Feels Comfortable

You might have to type your essay before turning it in, but that doesn’t mean you have to write it that way. Some people find it easy to write out their ideas by hand. Others prefer typing in a word processor where they can erase and rewrite as needed. Find the one that works best for you and stick with it.

writing knowledge articles

View It as a Conversation

Writing is a form of communication, so think of your essay as a conversation between you and the reader. Think about your response to the source material and the topic. Decide what you want to tell the reader about the topic. Then, stay focused on your response as you write.

writing knowledge articles

Provide the Context in the Introduction

If you look at an example of an essay introduction, you’ll see that the best essays give the reader a context. Think of how you introduce two people to each other. You share the details you think they will find most interesting. Do this in your essay by stating what it’s about and then telling readers what the issue is.

writing knowledge articles

Explain What Needs to be Explained

Sometimes you have to explain concepts or define words to help the reader understand your viewpoint. You also have to explain the reasoning behind your ideas. For example, it’s not enough to write that your greatest achievement is running an ultra marathon. You might need to define ultra marathon and explain why finishing the race is such an accomplishment.

writing knowledge articles

Answer All the Questions

After you finish writing the first draft of your essay, make sure you’ve answered all the questions you were supposed to answer. For example, essays in compare and contrast format should show the similarities and differences between ideas, objects or events. If you’re writing about a significant achievement, describe what you did and how it affected you.

writing knowledge articles

Stay Focused as You Write

Writing requires concentration. Find a place where you have few distractions and give yourself time to write without interruptions. Don’t wait until the night before the essay is due to start working on it.

writing knowledge articles

Read the Essay Aloud to Proofread

When you finish writing your essay, read it aloud. You can do this by yourself or ask someone to listen to you read it. You’ll notice places where the ideas don’t make sense, and your listener can give you feedback about your ideas.

writing knowledge articles

Avoid Filling the Page with Words

A great essay does more than follow an essay layout. It has something to say. Sometimes students panic and write everything they know about a topic or summarize everything in the source material. Your job as a writer is to show why this information is important.


writing knowledge articles

9 Simple Hacks to Write Better Knowledge Base Articles

tips to write knowledge base articles

A knowledge base is a set of organized information about your product or service that a reader can go through to learn about said product or service or how to solve related problems. It is usually a collection of articles with images, videos, and text included. 

Knowledge bases can be aimed at internal or external audiences and can serve different purposes.

For example, a software company may have FAQs and download instructions for their customer-facing knowledge base and also have an internal knowledge base for their employees to understand work-related tools and company policy. 

Knowledge bases are used by customer service, customer support, and customer education teams. 

Creating your own knowledge base article can benefit readers as they can find all the information they need in your article. We will walk you through nine tips that can get you through writing an informative, knowledge base article. 

1. Ask the right questions

This first step will prime your article for success. It’s important to take a close look at what you want to say, but more importantly, you need to recognize the needs of your audience and how your information will help your future customers or clients.

Is there a problem that your current customers face that you can help them with? That may be your next topic. Your goal should be to help users find answers to the questions they have about your product or service. 

To write an effective knowledge base article Here are five questions, which will help you develop excellent customer education content :

They’ll help you pinpoint your audience’s expectations and needs, as well as their current experience. 

2. Pick one idea per article

This might sound a bit like a high school English class, but see if you can also define your thesis statement . 

This will help you narrow down your article and create a specific answer for a specific problem.

Real-life example

For example, Slack doesn’t have a help article on “How to use messages.”

Instead, they target a specific customer need, such as, “Format your messages” or “View all your unread messages.” 

screenshot of a slack knowledge base article

3. Talk with subject matter experts

Understanding the “why” to your article will help you remain focused and pull targeted research. When possible, we suggest working with subject matter experts. 

However, if you need to draft a knowledge base template and you’re not an expert in the field, that’s okay. Interviewing a subject matter expert will help you work around that. 

4. Use headers to break up your content

Once you’ve decided on a specific strategy for your article, it’s time to start painting the picture. With the research you’ve gotten yourself or the information you’ve gathered from your subject matter expert, you can begin to outline your article.

Setting your subheadings (often written in H2) creates the base-structure of your article. They direct the structure and flow of your information and, most importantly, guide readers through your information. 

Take this example from Zendesk :

screenshot of a zendesk knowledge base article subheading

In their article they do a great job of breaking up their content using simple subheadings.

screenshot of a zendesk knowledge base article subheading

On longer articles, Zendesk even adds a table of contents at the top of each article.

screenshot of a zendesk knowledge base article table of contents

We’re all guilty of scanning the headers of an article before reading all the way through to make sure it’s something we want to invest our time in. Creating a headline that indicates what information is found below, you are well on your way to getting readers past the title.

5. Focus on your intro 

After you create your headers, you can shift the focus to your intro. Keep this short and sweet, but be sure to include your thesis statement or key message of the article up top.

writing knowledge articles

Your intro doesn’t have to be complicated. Even just a quick one or two-sentence summary can help add clarity for people looking for answers.

6. Kill the curse of knowledge

Always remember that your audience may have no knowledge on the subject matter at hand; you always want to use language that people of all levels of expertise can understand.

In the world of online education, step-by-step guides are an excellent tool to help someone learn something new or get help.

Start with the most basic details of your content area and build from there. If you don’t already, try creating a “Getting Started” guide or article list to help your users get started using. your product quickly.

You can advance to more complicated topics only after you’ve laid a solid foundation. 

7. Add images 

For many, this is the fun part. With your educational content in place, it’s time to add images.

Adding images will improve your content’s performance because, no matter how ‘good’ your content is, it will likely get overlooked without visuals.

And they’re really simple to create:

If your step-by-step guide is showing folks how to download and set up an application, include helpful screenshots of the process to help them visualize your information. 

writing knowledge articles

One thing to note with screenshots is that you need to make sure to keep them up to date .

Screenshots are just the ticket for taking your article from a helpful blog post to a full-blown reference guide, so, they’re well worth the little bit of upkeep that’s required. 

8. Add videos

Embedding videos in your article will also improve your content. Articles with videos often increase viewership more than those without. 

Having a relevant video in your article can increase the value a reader gets from your content and it typically keeps them on your page longer. The more time someone spends on your page, the more familiar they will get with your brand . 

Real life example:

In this example, Privy created a custom video to with their article.

writing knowledge articles

You don’t need to create a Hollywood-level video either.

To start, just record your desktop as you walk through the process.

Here’s a quick video that will show you how:

We recommend using Snagit , for short, quick videos, and Camtasia , for more advanced instructional videos .

9. See if you’re SEO friendly

Now that you’ve written your article, it’s time to make sure your article gets found. Here, we enter the world of Search Engine Optimization (SEO).

You always want to write your content organically and keep your user in mind. However, when all is said and done, you also want to make sure your information gets found on Google (and other search engines).

Because if people can’t find your help, it’s not very helpful.

The best place to start is with keywords.

In an article about building a company app, be aware of what search terms people are plugging into Google when they want to know how to do this. Is it, “building an app,” “how to build an app,” or “developing an app?”

Add important keywords

Fortunately, there are tons of free keyword research tools out there that will tell you what people are typing into Google to find information on your topic. With your primary keywords in hand, be sure to include them in the following areas: 

writing knowledge articles

Be cautious of keyword stuffing though.

For example, once you know which keyword will rank well, don’t stuff it into as many paragraphs as possible in an effort to rank higher. Google will actually penalize you for doing this.

Focus on your meta description

What exactly is the meta description? Think of it as a short blurb that describes what your article is about. This is what we scan when we pull up our search results on Google. It helps people see if the article is worth reading even before they look at your headers.

So, without question, your meta description is important and it needs to include your primary keyword. It answers, “What’s in it for me?” and entices online users to click on your article over anyone else’s work that pops up on Google.  

Include Alt text

Alt text is used to describe the function of an image. This is separate from a caption. People reading your article will be able to read your caption, but not the alt text (unless your image didn’t display for some reason). 

Search engine crawlers are what read your alt text . When Google (and others) crawl your site to index the content, it’ll pick up the alt text on your image and, if it has a popular keyword in it, you have the opportunity to rank higher. 

Write better knowledge base articles today

We love helping content creators include images and videos for better training, tutorials, lessons, and everyday communication.

When you’re ready to turn your next article into an almighty how-to with step-by-step guidelines, screenshots, and video, we’re here to help you bring that to life.

writing knowledge articles

Lizzy Smiley

Marketing Content Writing Specialist at TechSmith. I love my dog and The Office.

Subscribe to TechSmith’s Newsletter

Join over 200,000 people who get actionable tips and expert advice every month in the TechSmith Newsletter.

Tips & Templates for Writing Great Knowledge Base Articles

writing knowledge articles

When a customer hits a snag while using your product, the first thing they interact with won’t likely be a helpful member of your team — it’s more often a knowledge base article.

Much like your front door, you want to make your knowledge base articles as welcoming and friendly as possible. By defining and following knowledge base best practices, your team can ensure that this integral part of the customer experience is as helpful and impactful as possible.

We’ve collected a whole list of knowledge base best practices to make this process easy for you. Beyond that, you’ll find several knowledge base article examples and learn how to go about creating templates for them so it’s even easier to build effective documentation.

This is a chapter in our  Ultimate Guide to Using a Knowledge Base for Self-Service Support . When you're ready, check out the other chapters:

Chapter 1 – Knowledge Base 101: Definition, Types, and Benefits

Chapter 2 – Quick Start Guide to Creating a Knowledge Base

Chapter 3 – Knowledge Base Design Tips for Better Self-Service Support

Chapter 4 – Incredible Knowledge Base Examples That Get It Right

Chapter 5 – Tips & Templates for Writing Great Knowledge Base Articles

Chapter 6 – Creating Knowledge Base Videos: Tips, Tools, and Examples

Chapter 7 – Simple Knowledge Base SEO Tips Anyone Can Follow

Chapter 8 – The Best Knowledge Base Software + How to Choose One

Chapter 9 – Actionable Knowledge Base Metrics to Start Tracking Today

Chapter 10 – Knowledge Base Tips for a Better Customer Experience

Chapter 11 – How to Revamp Your Knowledge Base Architecture

What is a knowledge base article?

A knowledge base article is a piece of online documentation that answers a frequently asked question or provides instructions for solving a problem that customers commonly run into. Common knowledge base article types include informational articles, how-tos, troubleshooting guides, and FAQs.

Knowledge base articles are helpful for customers in all stages of their lifecycle, but they are incredibly impactful during the “help me help myself” phase of exploring your product.

But as Kathy Sierra shares in her book Making Users Awesome , companies often drop the ball with post-purchase publishing. Help content is usually one of the first things to feel the sting of mediocrity.

And while a knowledge base tool like Help Scout Docs makes it easy to create visually compelling knowledge base articles, clean, organized writing doesn’t come in the same turnkey fashion. It takes a sincere effort.

Discover the power of self‑service

Create and publish answers for customers and reduce your customer support volume by at least 20% with Help Scout Docs.

Discover the power of self‑service

8 best practices for writing effective knowledge base articles

The best help content is informative, engaging, unquestionably straightforward, and mindful of how and why a customer searched for help in the first place. To build knowledge base articles that meet all of those criteria, follow these eight best practices.

1. Don’t make assumptions

Customers turn to your self-service documentation to solve problems, so your most important goal is to be incredibly clear. Customize the tone that you use in your documentation for the audience reading it.

For instance, write your basic help desk articles imagining that the people reading them are complete beginners. Save the advanced terminology and jargon for advanced documentation, and be wary of mentioning to-dos in passing. It’s safer to assume that customers will need guidance for each step.

For example, if a customer is looking up how to migrate their website to a new host, which one of the following leaves the least room for error?

Before you continue, make sure to change your IP address.

Before continuing, change your IP address by going to Settings > Manage Domain > IP Address.

Option one assumes that the reader knows how to change their IP address, while option two meets the needs of both customers who know how to change their IP addresses and those who don’t.

Don’t self-sabotage by making assumptions about “simple” instructions. It’s better to over-communicate. More experienced users can simply skim past instructions they don’t need, but beginners will hit hurdles when you leave critical details out of your documentation.

Similarly, use pictures and videos where you can to ensure that nothing gets lost in translation. You may know what a specific term means, but it will be easier for your customers to understand if you show them what you are talking about.

2. Use anchor links in lengthy articles

Avoiding assumptions means that you may sometimes have to write lengthier knowledge base articles to ensure you’re explaining every step of the process.

When writing a longer article, include a table of contents with anchor links to make it easy for more advanced users to skip past the information they don’t need and navigate directly to the details they’re looking for.

Anchor Links Example

Even for average-length articles, users will appreciate being able to jump to the section they want. Links are also handy for list-type knowledge base articles like FAQs or best practices.

As an added bonus, well-structured documents also help search engines index specific sections of your content, making it even easier for your users to find them in a search.

3. Make the content easy to skim

Especially if you are writing significantly longer knowledge base articles, it’s essential to ensure that you don’t intimidate readers with a wall of text. When solutions aren’t easy to find, contacting support will be the customer’s next step, and no one wants to have to wait to resolve an issue.

Designer Rafal Tomal shows how proper use of subheadings and line breaks are a shortcut to an easily scannable document:

Rafal Tomal - Content Styling

Use headers, callouts, bullet points, spacing, and visuals to highlight important information and keep the complete set of instructions visible at a glance.

Here’s an example from our Docs knowledge base article about getting started with Workflows :

Help Scout doc - Workflows

It uses various types of formatting — bolding for navigational elements, an ordered list for steps in the process, and a different background color for a note — that attract attention to the critical pieces of information on the page. A reader scanning to find pertinent details will quickly find what they need.

4. Make things easy to read

A few key points to consider when you’re writing for a knowledge base are:

Write as you would speak to a friend, but edit to clarify your thoughts. Your knowledge base articles shouldn’t read like a stream of consciousness.

Consider your readers’ goals: Is the knowledge base article about learning the ins and outs of your product (curious) or fixing a bug or problem (frustration)? Adjust your tone and your content accordingly.

For articles on non-troubleshooting issues, a bit of humor is fine, but the line of annoyance is quickly crossed. Consider what frame of mind your customer will be in when they get to your knowledge base article, and write to that point.

Avoid slang and anything that may have an alternate meaning.

Get to the point quickly and simply, and use tools like Grammarly to cut out any extraneous content.

Stick to your brand’s tone guidelines while also writing the most practical knowledge base articles for your reader base. One of the best resources on the web for honing your voice in writing is Mailchimp’s Voice and Tone guide , which is a great resource for developing your own style guide.

5. Organize your knowledge base article logically

Good knowledge base articles become great when they’re designed around the reader’s workflow. As you create your knowledge base article process, add a step to consider where your customers will be when they read your articles.

Unless you want your customers to feel confused and disoriented and become even more frustrated, getting the flow right is vital. Here are three principles to live by:

Chronological order: It’s a must to organize a piece of help content in the chronological order of steps. The first thing your customers should see is the first step in the process they need to take to succeed.

Order by difficulty: If multiple tasks can be performed “first” (i.e., the order doesn’t matter), have customers do what’s easiest first. Early friction decreases the likelihood that they’ll finish or even follow your advice, so begin with a quick win.

Be mindful of workflow: Structure responses in a way that sustains activity and momentum. Avoid interrupting a problem-solving workflow until near the end.

Ensure you’re addressing related questions and issues by closing the article with a quick list of common follow-up questions, like in this example:

Docs-article follow-up questions

Put yourself in the customers’ shoes and consider what follow-up questions or needs they might have, and then answer them proactively.

6. Use links strategically

Including links in your knowledge base articles is a great way to direct customers to other details and instructions they may need. It also helps you stay focused on the topic at hand without covering every possible issue or piece of help a customer might need.

Article Table of Contents

While linking to other helpful articles is a best practice, it’s important to use links strategically. If you link to the wrong things at the wrong time, you increase the chance of readers getting distracted or more deeply confused. You want to nudge customers to click links only when following a link is the natural next step.

Besides embedding links directly into your content, you can also include related articles at the end. As mentioned above, including related knowledge base articles on topics that your reader might be curious about next is a great way to proactively help them move forward in their journey.

7. Stick with simple article titles

Restrain your creativity in favor of clarity, and keep titles as straightforward as possible. When stuck, ask yourself: What might a customer search for?

Better yet, if your knowledge base article tool offers insights like this, you can even look at what searches your customers have made and whether the search results returned anything. If you are a Help Scout user, our Docs report is excellent for this:

Sifter Docs report

Optimize your knowledge base article titles based on what people are searching for.

This list is also a great resource when trying to determine what to write. If you see that people are regularly searching for a document or category that you don’t yet have, you can use this search functionality to guide your documentation strategy moving forward.

Remember that people search with basic phrases. For instance, instead of “how to migrate your WordPress website,” they’d likely use “migrate WordPress site.” Create titles that include the operative phrases.

If you’re a Help Scout user searching for information on “forwarding emails,” our knowledge base returns the following:

Docs-article search titles

None of the titles are exciting. Instead, they’re straightforward — just as they should be.

Additionally, rely on action words in the active voice for a majority of your titles:

“How to (Blank)”

“Using (Blank)”

“Setting Up (Blank)”

Or use exact phrases of the actions they’ll take, such as “uploading your first video,” “installing your plugin,” and so on.

8. Use images to save time and create clarity

“Show, don’t tell” is important to remember when creating knowledge base articles. When you’re walking customers through how to do something in your system, you can write fewer words and make your instructions clearer by including screenshots or GIFs showing each step in your interface.

For instance, if a Help Scout customer wants to learn more about assigning conversations, this is what they would see in our documentation:

Screenshots Example

Each explanatory paragraph of text is followed by a screenshot showing customers exactly what they should see when performing that step.

4 knowledge base article templates and examples

Now that you know how to write excellent knowledge base content, let’s break down the different types of knowledge base articles and look at how you can create templates for them. Templates help keep the knowledge base article process clean and easy for your team whenever they need to make new content.

1. Informational articles

Informational articles help to review a specific system, function, or feature within your product.

They are not designed to describe problem-solving steps or get into the technical nitty-gritty of a particular feature. Instead, they educate the user on something they aren’t familiar with and provide an overview of any features or options available within it.

Here’s an example of an informational article from our support knowledge base:

example informational knowledge base article

This article, Understanding reports in Help Scout , is an overview of the reports functionality in Help Scout. Right at the top, we explain what this informational knowledge base article is about and provide quick links to jump to whatever topics are relevant to the reader.

Informational article template

Title:  About [Feature Name]

Description:  Brief overview description of the product or feature the informational article is about.

Links:  Anchor links to any of the individual topics within the more extensive informational article.

Further reading:  Links to related articles or other content around this specific feature.

2. How-to articles

How-to articles are similar to informational articles in that they describe how to use a specific feature without additional troubleshooting steps. They are typically structured as a list and should be limited to a single feature or task, like changing a password or adding a new user.

Here’s an example of a how-to article from our support knowledge base:

example how to knowledge base article

This article, called How to forward conversations , includes two topics, both of which have lists of steps to take to accomplish specific tasks:

example how to knowledge base article

How-to article template

Title : How to [task name]

Task:  A description of the task that your readers are looking to accomplish.

Prerequisites (if applicable):  If you have different pricing tiers, this should include information about which products or pricing plans this how-to applies to.

Table of contents (if necessary):  Create anchor links for quick navigating.


Outcome:  What users can expect to happen after completing the steps in the how-to knowledge base article.

Further reading:  Links to related knowledge base articles or how-tos.

3. Troubleshooting articles

Troubleshooting articles address a specific problem that a customer is having and offer steps to resolve it. Just like how-to articles, troubleshooting articles need to focus on one particular issue. While you can have multiple different options for troubleshooting, they should all be focused on a single problem.

For instance, you may have four different processes by which someone could resolve an issue with their browser. All four processes have a place in the troubleshooting article, but they all need to fix the same problem.

Here’s an example of a troubleshooting article from our documentation:

example troubleshooting knowledge base article

This article, titled Troubleshoot Email Delivery Issues with Google Groups and Help Scout , starts by detailing the different reasons why someone may run into delivery issues. It then breaks down the two causes in more detail.

We lead with the least complicated troubleshooting step and then follow up with the second option and a bulleted list of actions to try to fix it:

example troubleshooting knowledge base article

Troubleshooting article template

Title:  Troubleshooting [name of the issue]

Problem:  Brief description of the problem to be solved and the typical reasons why it occurs.

Anchor links to the specific resolutions (if there’s more than one).

Solution 1 (with a bulleted list, if applicable)

Solution 2 (with a bulleted list, if applicable)

Solution 3 (with a bulleted list, if applicable)

Outcome:  Brief description of how to understand if the issue is resolved or if it is still occurring after trying a troubleshooting step.

Further reading:  Links to related articles.

An FAQ page is a knowledge base article that lists common questions around a specific area of your product. For instance, some companies have an FAQ on things like shipping and order issues, payment processing, and account management.

You may consider having a single FAQ or several more minor FAQs for specific product areas.

Here’s a great example of an FAQ page from our Docs site:

example faq knowledge base article

The article, Learn about Help Scout Docs , starts with a video that walks through all of the Help Scout Docs product features. Then, there are a series of subheaders, each one dedicated to specific questions readers might have about the product:

example faq knowledge base article

FAQ article template

Title:  Frequently Asked Questions about [Product or Feature]

Topic (if applicable):  Brief description of the product or feature that the article pertains to, perhaps including images or an overview video.

Table of contents:  Anchor links to each question that is answered within the FAQ.

Further reading:  Links to related articles, such as how-tos or troubleshooting related to the product

Go forth and create beautiful, impactful knowledge base articles

Knowledge base articles are the first thing that most of your customers will see when it comes to your product. They have a variety of uses:

They can help educate users on your product.

They can answer commonly asked questions.

They can assist when troubleshooting specific issues.

Because of how integral they are to your customer’s experience, it’s very important to pay attention to how you write and structure them.

Create a knowledge base article process that supports your team in writing impactful, informative articles from the start, and then use precise language and a defined structure to ensure that your customers always know where to find answers when they need them.

Like what you see? Share with a friend.

Mercer Smith

Mercer Smith

Mercer is the VP of CX Insights & Community at PartnerHero, a yoga fanatic, and strives to make the world a little bit happier one customer at a time. You can find her at and on Twitter .

writing knowledge articles

Try Help Scout

Learn the platform in less than an hour. Become a power user in less than a day.

G2 Badges

The Complete Guide to Knowledge Base Articles

This complete guide will cover everything you need to know about writing Knowledge Base Articles for business, from setting the foundation of your knowledge base to updating and maintaining it.

20 min read

Knowledge Base Articles

What are knowledge base articles?

It’s for every business

Setting the foundation of your knowledge base, creating your knowledge base articles, steps to take after creating your knowledge base, knowledge base key takeaways, introduction.

In today’s competitive environment, it’s not enough to offer a good product. For a business to be successful, it needs to build a loyal pool of customers. To keep customers happy (and coming back for more) a business needs to have top-notch customer support. Not just for when things go wrong, but also to help customers make the most of a product or service.

Customer support is really where you can separate your business from competitors. Plus, it has a huge impact on your bottom-line with 64% of people saying that they prioritise customer service over price when dealing with a company. Offering great support also retains more customers. Businesses that increased customer retention by just 5% saw profits rise by a whopping 95% . But the stakes for customer support are getting higher because of increasing expectations. 67% of Millennials think that their expectations of what constitutes great service have increased in the past year.

That’s where knowledge base articles come in as a (relatively) quick way to vastly improve your customer support – and they’re even more important if you have a complex product.

Simply put, a knowledge base article features a set of information about a product as a user guide or to solve common problems. Although technically an ‘article’ it doesn’t always have to be written. Some companies use videos, images, infographics and animations to get their point across.

Creating an effective knowledge base article is tough. There’s a lot of ground to cover and many people don’t realise how involved it is. A good knowledge base article needs to keep things simple. It needs to speak to a range of different people from complete novices to techies and experts. It must talk about a lot of topics – anything that your users may need to know or any issues that they might encounter. Plus, it needs to be interesting and engaging.

So, it can be hard to know where to begin. To help you out, this piece offers a complete guide to creating knowledge base articles. From the bare bones of your strategy to measuring if it’s working and knowing when to give it a refresh.

The perks of having a knowledge base?

First things first, a knowledge base is incredibly useful for your customer support team. With a knowledge base at their fingertips, your team can quickly resolve common customer issues. They can point people towards specific documents or videos as a solution, instead of asking endless questions and trawling through a list of different troubleshooting options.

Of course, customers might not even reach your support team. A knowledge base gives them the freedom to search for answers to their questions without ever darkening your team’s door. This is preferable for some customers. 70% of customers prefer to use a company website to find a solution instead of picking up the phone or writing an email. Millennials, in particular, are well documented as phone-phobics, so if they make up a lot of your customer base then providing online support options are a must.

Having knowledge base articles available to your customers creates a kind of triage system for your customer support. Only the most complex questions and issues will reach your support team (the ones your knowledge base cannot resolve).

As an added bonus, having knowledge base articles can improve your website traffic. 45% of companies that offered some kind of self-service support option experienced an increase in site traffic and fewer phone calls to their support team.

To clear up a potential myth, don’t believe that you have to be a large business to reap the benefits of knowledge base articles. They work for every business. Every company needs to offer great customer service, from the smallest sole trader to the largest conglomerate. In fact, having a knowledge base can benefit small businesses more than larger ones. They’ve often got little-to-no dedicated customer support and limited resources, so a knowledge base relieves some of the pressure.

Before you ever put pen to paper there are a few steps to do that will ensure your knowledge base articles hit the right note. These will lay the foundations of your knowledge base, so it’s vital that you take your time and don’t miss anything out.

Know your audience

Your customer support needs to be tailored to (you guessed it!) your customers. Knowing your audience will inform every aspect of your knowledge base. They might not even like to read, for instance.

It will also tell you how simple your knowledge base needs to be, although a good rule of thumb is to keep it as accessible as possible. Most people cannot understand highly technical jargon unless they are industry insiders.

Without knowing your audience’s technical understanding or preferred form of learning, your base won’t be able to fully cater to their needs.

In theory, you should already have a good grasp of your customer behaviour as part of your marketing strategy. But if not, there’s no harm in consulting a few customers when developing your knowledge base. Releasing a ‘beta’ version to a select few can help you refine your content, the format and identify any areas for improvement.

Content is king of the knowledge base

Any good knowledge base article has great content. As previously mentioned, this doesn’t necessarily mean a text-only article. It can include imagery and video too. But good writing underpins all of this because you’ll have to come up with the script for a video or the words for an infographic. Our article on how to write amazing knowledge base articles covers this in more detail. 

Without the right content that covers every potential question and problem, your knowledge base will fail. It needs to simplify any technical concepts so that anyone can understand what you’re talking about. Jargon, acronyms (that aren’t spelt out) and buzzwords are a big no-no. You also have to make it engaging. If people don’t enjoy reading or watching it then they’ll switch off from your content. Getting ideas for your knowledge base can be tricky at the start, so we’ll offer some inspiration in another guide.

Identify common pain points

Problems that appear time and time again are perfect to include in a knowledge base article. If one customer encounters an issue, it’s highly likely that others will too. So save your team (and your customers) time and effort by including a troubleshooting section.

To uncover recurring and common problems, consult your historical customer support enquiries. Alternatively, you can sit down with your team and ask them about questions that crop up over and over. This has an added perk for your product development – any problems that can be easily resolved will improve later iterations of your products.

Where to locate your knowledge base

The location of your knowledge base shouldn’t be an afterthought. It needs to be in a place that’s often used by your customers. That’s why many companies put their knowledge bases in a dedicated customer support hub or on their website.

It also needs to be responsive, meaning your knowledge base can be accessed from any device including mobiles and tablets. If you’re using Document360 to create your knowledge base then this won’t be a problem as this happens automatically for all content.

Calendly is a relatively simple online tool to use (it only involves a few clicks!) so it hosts its knowledge base on its website. Customers can access it from the footer of the homepage and it then reveals a list of different topics. These expand further into the articles themselves and further options.

Think of the format

Another key decision that you must make about your knowledge base is how to format it. Some companies, such as Calendly, use purely visual formats like videos. Others will use only text-based. As a start, there are tons of article templates that you can use freely available online.

What you decide on will depend on your customers. Consider what channels they actively engage with already – do they prefer to read your content or are your videos particularly popular?

A mix of different formats can work well. Wunderlist uses a mix of words and screenshots to help guide users through its tool. You could also do a summary video and go into more detail in your text later on. Having some text in your knowledge base helps with SEO too. Our article on how to SEO your knowledge base articles goes into more detail on this.

Make it easy to navigate

How you structure your knowledge base and its articles will either help your customers sift through it all – or confuse and frustrate them. Some of your customers will likely be turning to your knowledge base because they have a problem, that means they’ll already be stressed and annoyed. So, you want to make it as simple and intuitive as possible to navigate through your knowledge base.

It goes without saying that it needs to be well planned and logical to follow. For your structure, there are a few different options:

Decibel Insight shows a good example of a knowledge base structured in categories.


Whatever structure you end up using, remember that your customers should learn everything they need to know by going through it from start to finish.

Numbered steps can be helpful when guiding users through a particular set-up or problem-solving task. LastPass does this well for users who cannot gain access to their account. It also features an extensive FAQ section of commonly asked questions and an option to escalate the case.

After laying the foundations of your knowledge base, it’s time to start creating it. This may take some time, but you can always prioritise or rank articles by how important you think they are and how much your customers are likely to benefit from them. A knowledge base is a work in progress, so you should always be adding content to it.

Speaking of which, it’s a good idea to get yourself some knowledge base software that will grow as your business grows. You don’t want to put lots of effort into a knowledge base that fails to scale with your organisation!

Getting to grips with technical writing

You’re likely to need to do some technical writing at some point in your knowledge base creation. Technical writing is a bit of a unique skill, in that it takes complicated and jargon-filled information and simplifies it for everyone to understand. It’s so involved, that we’ll go into more detail about popular tools for technical writing.

Titles and headings need to be simple

Titles and headings will help your customers find the answers that they are looking for. Don’t get too creative with them, instead focus on creating instantly understandable, simple titles so customers can easily click on the right one. Action words work well in knowledge base titles, that’s words like ‘How to’ and ‘Using’.

Having a menu that is easily accessible (scrolling with them on the side of the web page, or static at the top) can help customers even more.

Subheadings within an article will help break up long sections of text or lots of information, plus it helps customers who might be skim-reading. You could also include a bulleted brief at the top of each article for people who are only looking for a summary or quick solution.

SEO should also be considered in your titles. Consider what phrases people will be using to search online. Usually, they revert to a caveman-type speak such as “reset master password LastPass”.

Images can inspire and engage

Knowledge base articles can be dry and long-winded if they aren’t broken up effectively. One good way to do this is to use a mix of imagery, from screenshots of your product to infographics.

Some customers will be visual learners so imagery will really help them understand your product. Infographics, graphs, tables and charts can also summarise your articles for customers with limited time. They aren’t too difficult to create either, online tools like Canva mean you don’t need a graphic designer to knock-up a quick visual – and Snagit is a great option for image and video screenshots.

Keep it concise and simple

Incidentally, many customers won’t have much time to sift through reams of information. So you should break your article up into ‘skimmable’ chunks. One good rule to follow when evaluating the length of your article is: if you cannot read through an article yourself in an entire sitting, then it’s probably too long.

Bullet points can help break up text and summarise information, or if your article is really long you might want to consider breaking it down into a series of smaller posts. Again, imagery is your best friend in this scenario – infographics can highlight key points and videos are great for quick run-throughs.

Google Analytics’ knowledge base uses mini content sections to help navigation through its articles. These are located at the start of each article, allowing users to jump straight to the answers that they need.


Check your tone of voice

The tone and type of language that you use need to reflect your brand and any other content your company has already published. It needs to be engaging, but also informative, not too technical and it shouldn’t be confusing. People need to get its meaning immediately, otherwise, they’ll be frustrated.

Make sure that your language is straightforward and talks like your customers talk. Nobody really chats in jargon or acronym, so keep these out of your articles. Avoid being salesy too, at this point you’re trying to onboard someone or solve a problem, so it really isn’t the time or place for selling.

SEO-optimising your knowledge base

Again, a really involved topic that we’ll get into more in another guide. For now, you need to be mindful of some SEO best practice to help your knowledge base rank in search results. Stick to commonly used search terms for your titles and focus on one or two keywords in each article. These keywords need to appear in any text, as well as image and video descriptions, headings and subheadings. Plus, you can include links to other articles in your knowledge base if they are relevant, as these can help boost your SEO further.

Keep an eye on the details

Details matter in a knowledge base article. If there’s something important that your customers need to know for that specific solution, then make sure you include it; for example, if a certain function is only available on a higher tier plan or if information needs to be in a certain format. If it’s a bit tough to write out, then use a video or screenshot that points directly to what you’re talking about.

Take a look at Hootsuite, which does this well when it highlights that a date needs to be in a specific format when scheduling content. This saves a lot of time, effort and frustration in the long run because attention is drawn to the program quirk early on!


Collaborate within a wider team

You don’t necessarily have to do all the work when creating a knowledge base. This is especially relevant if you have a large user group and an extensive product range. Instead of one person spending all their time creating a knowledge base, share the load with different people within your organisation. Coworkers in other departments might also be best-placed to create a guide on a certain subject.

Just make sure that everyone is communicating regularly and that they stick to the same style and tone. This can be made a lot easier by using Document360 , which offers collaborative tools as part of its knowledge base software.

Search functions help your customers find stuff

Along with menus, headings and other navigation tools, you should include a search function to help your customers locate the articles that they need. Remember, your customers are likely time-poor so anything that can help them find answers quickly will vastly improve their user experience.

But, of course, make sure your search function actually works well! Results need to be relevant to the question or phrase that a customer has typed in. It’s a good idea to always include contact information for your customer support team somewhere obvious in the results as well – just in case your knowledge base can’t answer your customer’s enquiry right away.

Document360 offers a fast search function as part of its knowledge base software. This goes a step further than a simple search, predicting what your customers are likely looking for as they’re typing out their enquiry.

We like Survey Monkey’s style when it comes to the search on its knowledge base. The results are simple and clear, plus there’s a highlighted option to contact the team if the search results don’t provide the right answers.


Your work isn’t done after you’ve created your knowledge base articles. There are a few other steps that you need to do regularly to ensure your knowledge base remains useful and up-to-date.

Get regular customer feedback

Gaining feedback on the usefulness of your knowledge base will help refine it and make it even more useful to your customers. Document360 offers a quick feedback option for any customers using one of its knowledge bases. This quickly tells a company if their knowledge base is ticking all the right boxes or if there’s room for improvement.

It’s also worth asking your customer support team if the knowledge base has helped with their daily work. Have regular meetings with your team to review your knowledge base and see where content might be missing or need a refresh.

Freshdesk has a short survey included at the end of all its articles. After reading the guide, users are asked if they found it helpful and – most importantly – if they select ‘no’ then whoever wrote the article is sent an alert. This instant action then tells the author that they need to return to the article and look for ways to improve it.


There’s hidden gold in your analytics

The data behind your knowledge base can be a useful form of feedback as well – telling you whether people are using the articles and what content is most popular.

Not only will this tell you if your knowledge base is a hit, but it might also highlight any issues that many users are experiencing. This gives a valuable opportunity to improve your products and remove any recurring problems or pain points.

Constantly update your knowledge base articles

As previously mentioned, your knowledge base is a work-in-progress. Your work is never completely done on one! It’s an embodiment of your business, your customer support and products. As such, you need to review it regularly (set yourself a calendar reminder at least every quarter or bi-annually) to check that it is helping your customers and reflects the current state of your business.

New products will have to be added to the knowledge base, new languages might have to be supported if your business expands globally and articles that aren’t working well will have to be redone.

The SEO of your knowledge base articles should be double-checked to ensure there are no broken links that might be negatively impacting your ranking. If you’re feeling thorough, you can also review current SEO best practice to see if your articles need a bit of tweaking to still rank well.


Starting your knowledge base can be time and resource intensive, but it will pay off in the long run. Once you’ve created it, you can continuously work on your knowledge base articles to improve and add to them. Plus, creating your knowledge base can be a lot easier if you use a dedicated software to do the technical groundwork.

Your knowledge base articles will be the backbone of your customer support. So don’t neglect it. Make sure you adapt your knowledge base to any product or business changes in your organisation, as well as refine it based on feedback.

In this day and age, every business needs a knowledge base. Good customer support is the very least that is expected of your company. Fail to meet your customers’ expectations and you’ll see them headed for the door. Provide a good knowledge base and stop them in their tracks.

Oh no! We couldn't find anything like that.

Try another search, and we'll give it our best shot.

An Easy Guide to Writing Effective Knowledge Base Articles [+ Templates]

Swetha Amaresan

Published: June 23, 2022

Raise your hand if you like waiting on hold for customer service?

Service rep using knowledge base templates

When faced with calling customer service versus finding the answer ourselves, we'd much rather solve problems on our own.

Having a webiste with a knowledge base empowers customers to reslove their issue without needing to contact customer service. This isn't exactly the best news for someone in customer service , but it doesn't mean your job is becoming obsolete. Rather, it's evolving to fit the changing needs of customers.

→ Access Now: Free Knowledge Base Article Template

Creating an effective knowledge base is a big undertaking. We've put together a handy knowledge base template to take the guess work out of helping customers find the resources they need.

What Is a Knowledge Base?

Knowledge bases are online databases that store information about a specific company, its products or services, or related industry topics. The data is either collected and stored through artificial intelligence or manually uploaded by expert contributors.

A company's knowledge base can provide valuable information to customers, prospects, and even employees. You can include important facts about each department, directions for product or service usage, FAQs, and original content that can provide in-depth solutions.

HubSpot's knowledge base helps us better serve and delight our customers by helping them access the solutions they need 24/7. Knowledge bases have also decreased the need for customers to search for questions on search engines. They can simply search the same question on your company's knowledge base, knowing the answer will exist in relation to the appropriate product or service.

Knowledge Base Article

A knowledge base article provides information about a specific product or service and acts as a guide to help users solve common problems. They often provide step-by-step instructions on how to use the product and all of its features.

These articles also don’t have to be limited to written content. They can come in the form of an infographic, video, gif, or other visual aids.

Knowledge base articles allow users to find the information on their own and resolve issues at their own pace while also freeing up time for your customer service agents since they won’t have to answer the same, repetitive questions. Common types of knowledge base articles include:

It's evident knowledge bases are an invaluable resource to both your company and your customers. But, how do you go about creating one?

How to Write a Knowledge Base Article

When a customer is looking for a solution to a problem, your knowledge base should make it as easy as possible to find answers. It's important that your knowledge base articles not only contain the solution that the customer is looking for, but is also formatted in a way that makes the answer clear and obvious. When writing new articles for your knowledge base, check out this guide for writing effective knowledge base articles.

Featured Resource: Knowledge Base Article Template

HubSpot free Knowledge Base template

1. Select simple titles using target keywords.

Knowledge bases are mainly for your customers and prospects, and not internal stakeholders. Thus, the language being used in the titles and articles should be simple, clear, and concise.

When choosing titles, put yourself into the customer's shoes. What kinds of topics would they search for? What's their expected difficulty level in terms of knowledge on the product or service? Write titles based on this information. It's also helpful to use search-engine-optimized keywords in the title to attract more search volume.

The most common titles start with:

It's also helpful to use search-engine-optimized keywords in the title to attract more search volume. In addition to the list above you can also title articles based on the actions your customers will be taking. For example you could write “Creating your first video” or “Installing a widget.”

2. Only have one article per specific topic.

It's inefficient to have more than one article for the same topic. Not only does this split traffic between multiple articles, but it can get confusing for customers if they have to keep switching back and forth between multiple pages to find all the information they need.

If you gain more information on a topic, do a keyword search to see if there are any articles with similar keywords. If so, you can update the existing article with more information.

This will make the article more all-encompassing so readers can gain all the information they need from a single source.

If you’d like to cover a related topic, you can link to it in the existing article. We’ll discuss covering related topics later on in this post.

3. Categorize articles for easier browsing.

Knowledge bases aren't just for searching. While many customers will search specific questions to solve problems, they may also use the database as a way to browse through related topics. This means your articles should be categorized by sections and subsections.

For example, on HubSpot's knowledge base, you can search by HubSpot product, the type of resource, or a variety of topics, such as Blog, Dashboard, Emails, Integrations, and Sales Templates.

Knowledge Base example: Pinterest

Pinterest's knowledge base for business (pictured above) groups articles with easy categories like Create a shop, Advertise, and Create content to help users quickly identify the articles of interest.

Using categorieskeeps the knowledge base organized and ensures every article has a place and a purpose.

4. Include a table of contents, if needed.

Sometimes, an article can get pretty long, especially if you've updated it with added information. Dedicated customers will scroll until the end when they want an in-depth, complete understanding of the problem and solution.

Knowledge base example: HubSpot table of contents

5. Describe the problem, if applicable.

Start off the article by stating what the problem is, for scenarios that are problem-solution based. Not all knowledge base articles are meant to solve problems; some may just explain how to complete a task. In those cases, you can skip this step.

Identify what the symptoms of the problem are to clearly relay what customers should be looking for. For example, list what error messages should be popping up if the problem does exist. You want to use basic language and make it as clear and concise as possible. The briefer this section is, the better, as people reading will likely be looking to get to the steps to solve their problem quickly.

6. Relay the steps to accomplish the task at hand.

After stating the problem, you should immediately jump into showing readers how they can solve the problem. Lay out this section in easy-to-read steps that can be read and followed in succession. You want to make sure the steps actually solve the problem they claim to solve. If the problem can't quite be solved, the steps can help eliminate potential causes or reveal what the root problem is.

You'll want to lay out steps specifically for articles that are solving problems or showing how to accomplish a task. For comprehensive guides, you might not need to utilize steps. Instead, you can divide up the text by explaining different aspects under separate headers.

7. Announce what the solution should be.

You should end the article by describing what the solution is. After all, since not every problem can be completely resolved, the solution may be an improvement of the problem or an update of a product to avoid a former glitch. If needed, you can explain why a permanent solution couldn't be attained but that the solution laid out is the best case scenario for improving their situation.

If there's no direct solution, or if the end result is self-explanatory, this step may not be needed. Instead, you can reiterate in the final step or paragraph that you've reached the end and that the task has been achieved.

8. Offer other article links for further reading.

You never know if you've completely exhausted a topic for interested readers. Rather than making them browse through related articles on their own, you can link some of your other articles at the bottom or side of the article.

This will help customers gain a more well-rounded education on the topic at hand. And, it helps get more eyes onto the articles you and your team worked hard to create. The more your readers use your knowledge base, the more they'll trust your organization as a source of accurate information.

These steps can help you create knowledge base articles that are effective and clear. However, not every article will be structured in the same format. Articles can vary in layout and design depending on the solution they're providing.

9. Show, not tell.

When trying to explain a concept or deliver instructions, visual aids can work wonders to communicate your ideas. This is especially true when you’re trying to explain a complicated topic.

Rather than just posting a wall of text instructions, consider using photos, charts, video and other media to help the reader gain understanding. This method can be super helpful when describing a multi-step process.

Knowledge base example: Semrush visual aids

Semrush uses a combination of photos and gifs to walk readers through checking their online visibility. This way readers get a step-by-step visual breakdown showing how to complete the task.

Words are great, but can easily be misinterpreted. Showing users how to solve their issue rather than just telling them will help them follow along and accomplish their task.

10. Ask for feedback.

While you may think you have the best knowledge base out, you should always strive to make it better. Who better to help you with that than the people who use it?

Each article should have a spot where users can submit their feedback. The CTA should be as simple as possible and not require a heavy lift on the user’s behalf. Instead you can ask them a simple question like “Was this article helpful?” or “Did this article resolve your issue?” with a simple yes or no option response.

knowledge base example: Semrush feedback survey

Semrush, pictured above, uses a simple thumbs up or thumbs down symbol to solicit user feedback. It’s quick and effective. For those that answer “no,” you can add a text box pop up for users to further explain what went wrong. Understanding the user’s pain points and making adjustments will improve user experience and the effectiveness of your knowledge base.

Knowledge Base Article Templates

The structure of a knowledge base article plays a major role in the piece's clarity and appeal. Customers are looking for specific and concise answers, and don't want to waste time scrolling through an essay to find it. Utilizing the common knowledge base article templates can play an instrumental role in determining the effectiveness of your self-service customer support.

knowledge base template: how-to article

Image Source

How-to articles are typically brief. They show you exactly what steps to take to complete a specific task or perform a certain function. This is usually the type of knowledge base article that helps visitors solve problems they're facing with their products.

How to [Name of Task]

Applies to [Your Appropriate Products]

[Brief Description of Problem, if Needed]

[Brief Description of Solution, if Needed]

Related Articles:

[Three to six articles with links]

knowledge base template: FAQ

FAQ articles include a list of questions about the same, related topic on a single page. This includes general and tool-specific questions. They're usually all listed at the top in a table of contents with anchor links that allow you to jump down the article to the specific question you need to be answered.

[Topic Name]: Frequently Asked Questions

[Brief Description of Topic]

Table of Contents:

[Question 1]

[Question 2]

[Section 1]

[Section 2]

[Tool-Specific Category 1]

[Tool-Specific Category 2]

3. Tool Description

Knowledge base template: tool description

Tool description articles give a short description of what a specific tool or function is. Rather than answering questions or laying out steps, it tells you exactly how something works.

[Tool or Function]

[Brief Introduction of Tool or Function]

[Description of Tool]

[Final Tips/Information to Note about the Tool]

4. User Guide

User guide articles are long, comprehensive guides that cover an entire tool or function. Similar to an instruction manual, they include information on using every single feature to give you a well-rounded education on the tool or function.

A Guide to [Tool or Function]

[Main Feature 1: Description]

[Main Feature 2: Description]

5. Quick Answers

Knowledge base template: quick answers

Quick answer articles highly resemble user guide articles. They, too, are long, comprehensive guides that cover an entire tool or function. However, the difference is that quick answer articles include a table of contents in the form of anchor links -- like FAQ articles -- that allow you to jump down the article to the specific topic you want to learn more about.

[Tool-Specific Category 1]:

[Tool-Specific Category 3]

[Tool Specific Category 1]:


It's always helpful to include screenshots as examples for any tools, functions, steps, or descriptions that may be confusing to explain in words. Also, by showing your text alongside a visual, readers can follow along on their own product while reading your knowledge base and compare their progress.

Create Your Knowledge Base

Knowledge bases empower customers with the information they need to resolve issues and allows your service team to have some variety in their work day. Keep your articles clear, descriptive, easy to navigate, add helpful visual aids and you'll be sure produce resource that delights customers.

Editor's note: This article was originally published in March 2019 and has been updated for comprehensiveness.

New Call-to-action

Don't forget to share this post!

Related articles.

How to Create Technical Documentation in 6 Easy Steps [+ Examples]

How to Create Technical Documentation in 6 Easy Steps [+ Examples]

What is a Knowledge Manager? (+ Job Description and Responsibilities)

What is a Knowledge Manager? (+ Job Description and Responsibilities)

What Is a Knowledge Base, and Why Do You Need One? [Definition]

What Is a Knowledge Base, and Why Do You Need One? [Definition]

18 Best Knowledge Management Software

18 Best Knowledge Management Software

How to Create a Forum Website for Discussion & Customer Service

How to Create a Forum Website for Discussion & Customer Service

This Data Shows Why Brands Need a Knowledge Base in 2020

This Data Shows Why Brands Need a Knowledge Base in 2020

Do Customers More Frequently Use Chat or Phone Support? [HubSpot Data]

Do Customers More Frequently Use Chat or Phone Support? [HubSpot Data]

HubSpot's Customer Support Experts on How to Develop a Service Strategy for Social Media

HubSpot's Customer Support Experts on How to Develop a Service Strategy for Social Media

5 Things That Distinguish a Knowledge Base From a Company Blog

5 Things That Distinguish a Knowledge Base From a Company Blog

How to Perfect the Search Function of Your Knowledge Base

How to Perfect the Search Function of Your Knowledge Base

A free knowledge base article template (+4 other free templates).

Subscribe for blog updates

Thank you for subscribing!

OOPS! something went wrong try after sometime

How to write a perfect knowledge base article

How to Write an Effective Knowledge Base Article

According to Statista, 88% of customers expect companies to offer an online self-service portal. Creating a great knowledge base article is the first step to promoting self-service. But how do you create a great knowledge base article? How do you choose which questions need to be answered in your knowledge base? And how do you measure if your knowledge base is successfully helping customers get quick answers, while unburdening your support team? Here’s a quick guide for you to write different types of knowledge base articles and help your customers find answers without any agent assistance.

What is a knowledge base?

A help desk knowledge base is a repository of information about your product or service. This curated resource portal can be leveraged to find answers to product-related issues or may contain a step-by-step guide t o learn how to use the product or service. A modern knowledge base will support multiple formats of learning, including solution articles or FAQs, product manuals, tutorials, videos, and troubleshooting guides, all categorized into distinct themes or folders. It acts as the source of truth for the product or service to its stakeholders i.e. customers, employees, and partners. 

A knowledge base may be a part of a company’s self-service portal or may be a section on its homepage. For easy navigation, it’s advisable to add a search functionality that helps customers type in their queries to get directed to relevant resources right away.

Advantages of creating an effective knowledge base article

According to Forrester, self-service yields a better CSAT rating as compared to a virtual agent interaction. That’s not all. A knowledge base is equally useful for your customer support agents as much as it is for your customers. Your support agents can refer to the internal knowledge base articles to answer any customer queries quickly instead of reaching out to someone for guidance or trying multiple solutions. On the other hand, your customers can search for answers to common questions in the knowledge base instead of contacting your support team and waiting for a reply.

The end-to-end guide to an effective knowledge base article

It doesn’t matter what the size of your company is or the kind of industry you work for, getting started with the creation of a knowledge base is easy. You can even make use of a knowledge base software to choose a template of your choice, create the table of contents using search optimized article titles, and provide structured solutions to commonly raised concerns.

Remember: Your customers should just a web search away to your knowledge base articles.

There are no predefined rules to creating the best knowledge base article. You fail, learn and repeat. We have written hundreds of articles for our knowledge base, and it is used by over 150,000 customers. Having leveraged SEO to our advantage, we are still experimenting with the way we optimize our articles so they are easily searchable.

Here’s a look at what worked for us (and a little bit of what hasn’t).

Getting started with a knowledge base article:

Before writing the knowledge base article:

While writing the knowledge base article:

After writing the knowledge base article:

When you are creating your knowledge base for the first time, you will have a lot of topics to choose from. Start by collaborating with your customer support team to collect and analyze customer feedback. Enable your team to leverage these insights to deliver an exceptional customer experience by creating help articles that encompass step-by-step instructions to perform tasks in no time. You can even save time on creating your articles by creating knowledge base article templates for How to, User guide, FAQs, and more. 

One of the following techniques (or maybe both) should help you identify and prioritise which KBase articles to create first knowledge base:

What are the questions that have been frequently asked by your customers to your customer support team ?

If you are not sure, browse through your support tickets from the past month (or week, if the ticket volume is huge). If that doesn’t give you enough information, find out what your customers are searching for by looking at your search terms in Google Analytics.

Tip: Connect your support portal to Google Analytics and get insights

Enlist these identified keywords and search terms. The next step is to start creating and adding these articles to your knowledge base.

Here’s a way to approach the creation of help articles. Write down the top 10 things your customers should be doing for them to see value in your product. Should they invite their team to use it? Should they import data from their previous system?

Collaborate with subject matter experts to write support articles that can assist your users in using the product/service to their advantage. Organize them based on the key features so that customers who visit your support portal can find them easily. You can also create a seamless customer experience for users visiting your support portal by creating playlists. This gives you an opportunity to categorize articles and let your customers transition to the next relevant article without the need to exit the portal.

While answering FAQs will help your agents immediately, writing articles that help onboard new users will help you in the long term. We started out by writing basic FAQs and now, we write articles for every new feature that gets launched.

You have to make sure you have researched what you need to achieve before even getting started with a knowledge base article. Take time to understand and confirm the topics you should write about, identify customer pain points and determine the structure of your article.

Before writing a tutorial, follow the step-by-step instructions yourself. You may even ask a couple more people to try the same. Take notes as and when you get stuck or about the steps that got others confused. Did something result in a delayed response? Do you need to rectify any of these aforementioned steps?

You might have a lot of tickets recorded on your helpdesk. Go through related tickets and find out where your users face issues. This approach will help you anticipate user pain points and questions, and present a way to eliminate or avoid these using troubleshooting guides. With the right software, your help desk can categorize tickets based on the queries raised, further reducing human effort.

Example of understanding user pain-points

You are not writing your knowledge base articles for just one kind of customer. What comes easy for a power user may be too complex for an average user. If you feel like you need to explain more to a newly onboarded customer (wrt the information that a power user would like), split the use-case into multiple articles and link them to the original longer article . This way, the article written for the average user doesn’t need to have too much information.

For example, while explaining about the social tab in Freshdesk, instead of just telling users ‘You can search Twitter using the social tab’, we wrote a separate article on how to search on Twitter (that a power user wouldn’t need) and linked it to the original one.

Different people learn differently. Some like to learn using images and videos while some prefer a step-by-step manual to get started. You need to put yourself in the shoes of the customer to determine the format and the kind of resources that need to be shared using the article. Figure out the sufficient number of screenshots that make the process self-explanatory. Based on the customer behavior, you may also determine if it’s a better idea to incorporate a video instead. You may even add a video at the end of every article.

Take Wistia’s FAQ section for example. Even though they’re a video-hosting company, they don’t fill the entire page with videos without text.

Note: We experimented with presentations and GIFs as a medium, but found that people need a quick solution and don’t wait to watch the different steps in the animation.

You should not let your exposure to customer problems affect the article in a negative way. If you actively support your customers, you are likely to remember all the problems customers face as far as the features are concerned. If you are a tech writer, you are also likely to remember the step-by-step demo you received from the product manager.

Your article about a product feature should neither be a detailed explanation of the UI nor a mini-FAQ. It should be a mix of both. This allows users to understand and learn about the feature and find an effective solution to specific problems.

Here’s an article on SSO on our support portal to help our users understand remote authentication and address common user problems that may involve them getting locked out of their account.

Now that you’ve figured out what you should be writing about and what points you should get across, it’s time to actually write the articles. Make sure you stick to the basics and actually follow through on your plans.

1) Talk like your users talk

Do not use over-the-top words or technical jargon in your articles. Find out what customers call the feature you are writing about (use search terms in GA or by reading tickets). Use those words in the article, headings, and subheadings to help them understand your article easily.

2) Be straightforward.

Your articles need to be easy to scan through and understandable in just one read. You can create tutorials in a way that makes them easy to consume. If you want to improve customer experience, personalize the template, not the content (take a cue from Amazon).

Amazon knowledge base

3) Feature trumps benefits

When you write on a support portal, remember that you are not trying to sell. A solution article is written to help, not to convince. So your articles should talk more about the nuances of the features and not cover the benefits of using your product .

4) Treat every article as a mini-onboarding process

Start by explaining the feature in simple words. Then, use an example to walk the customer through the product interface and let them know what happens once they follow these instructions. This way, even if the setup process is elaborate, users will follow it through till the end.

5) Bullets and tables are your best friends

Needless to say, formatting solution articles is extremely important. Carefully choose your headers and subtitles. Structure your articles using bullet points and arrange your content using different sections. You may even make the action items bold in each step so it’s easy for readers to skim through your content.

6) Always state the prerequisites

Don’t make it hard for users to find out the limitations of a product . If your app doesn’t run on IE, say it. If this feature is available in the highest plan only, say it. You will save yourself from unnecessary grievances or concerns by being upfront about your services .

7) Nothing is too obvious

Don’t leave out even the tiniest of details assuming that it’s obvious. Use a tabular form or create annotated screenshots when you want to explain multiple little things without making the article too long.

8) Do not sell.

Selling or upselling in support articles is like selling a support ticket (not recommended).

You’ve finally finished writing your article. You can now move on to the next task and forget about this one, right? Nope.

You are not done writing a support article once it’s published. You have to make sure that it is useful, that it’s updated from time to time and it serves the purpose of helping your customers resolve their issues by themselves.

Go through the article you had just written one more time and find out if you can embed any other solution articles. Repeat the same exercise for the other related articles and provide links to the new article.

For example, if your new article talks about plans and billing, you can link it to the one about payment options. This helps readers navigate easily (even if they land up there by mistake) and it increases the chances of the article being found on search engines.

A few days after your article is published, you can check if your article is actually helping your agents and customers. Has it reduced the number of tickets for this feature? Are other agents using this article to support their answers? If not, why?

Here’s a way we made life simple for our support team. Freshdesk’s knowledge base has a small survey at the end of every article. Every negative feedback gets converted into a ticket in the helpdesk in which the author is added as a viewer. This way, the author can quickly update the article based on the feedback received.

How to write an effective knowledge base article

Extend KBase to AI Chatbots

Integrate your knowledge base with your AI chatbot to automate FAQs for your customers. Chatbots offer self-service through conversation, reducing the effort of searching for answers in your knowledge base.

Smart chatbots learn from every customer interaction and offer intent-specific answers by pulling information from your knowledge base directly. Not just that, chatbots even go above and beyond to inform you of the gaps in your information and signal the scope for improvement of your answers.

Your checklist for writing a knowledge base article

Here are the steps you need to follow to write a knowledge base article:

A knowledge base article is perfected over time as you update it based on the feedback you receive from readers and support agents.

The perfect article also differs from business to business. You can follow this article to get started with the first few knowledge base articles, but once you get accustomed to the workflow, you can experiment and figure out what suits your customers’ needs. Even if you cannot see the effects of the articles on your users right away, it will be helpful to your agents from day 1. It is also a great way for new agents to get up to speed with your product/service.

Here are some of the tools we use to create our knowledge base content:

Your turn now.

What are some of the things that worked with your knowledge base articles? What are some articles that helped you out as a user? What are some best practices for writing a knowledge base article that you’ve learned from your experience?

Share with us in the comments below.

Originally published on Jun 1, 2018. Updated on February 16, 2022.

writing knowledge articles

Related Posts

The art of writing awesome emails that customers love, how to keep support agents engaged and motivated.

How to Write Effective Knowledge Base Articles [With Examples]

Writing great knowledge base articles isn’t as hard as you think. Learn how to craft first-rate content that empowers customers to help themselves.

Last Updated

February 26 2021

Example of a knowledge base article created in Helpjuice

The key to writing great knowledge base articles is ensuring the content is clear, engaging, and informative for your end users.

The good news is that crafting awesome content for your knowledge base isn’t nearly as complicated as many people think. 

With the right approach and a dash of know-how, you can author articles to improve your customer's and employee's experience with minimal stress.

In this article, we’ll run-through eight best practices for creating great help content as well as share several examples to inspire your own.

How to Write Effective Knowledge Base Articles

When you boil it down, the difference between ineffective help content and brilliant help content is this: Brilliant help-content empowers users to accomplish whatever they set out to do.

The following 8 steps will ensure your knowledge base content helps users get the job done:

Understand User Pain Points

There’s nothing more essential for writing great knowledge base content than understanding why your users are looking for help in the first place. Because figuring out what questions your customers are asking and identifying common themes directs you to create the most relevant content.

The good thing here is that most business owners already have a decent idea about where their users are getting stuck. But if you’re not sure, have a rummage in these 4 places:

Assume Reader’s Know Nothing

One of the worst things that can happen in a knowledge base is that your writing confuses your reader by talking about things they don’t understand.

To avoid this, assume your readers know zilch. Compose your articles as if you were communicating with an absolute beginner. 

You don’t need to dumb things down per se - think more along the lines of swapping out technical jargon and explaining difficult concepts in simple language.

For example, before explaining how customers can get started segmenting their email lists, the marketing automation platform Mailchimp defines several key terms new users might not be familiar with.

Example of knowledge base article from Mailchimp

Bringing readers up to speed like this ensures that they won’t get lost further down the line when more complex problems are introduced.

Another habit that'll torpedo your articles is mentioning ‘how-tos’ in passing. For example, let’s suppose a reader wants to edit their photos using a piece of software

Which of these would be a more helpful solution?

Number one assumes the reader is already familiar with how to import photos. Number two, on the other hand, works for both those who know and those who don’t know how to complete the task.

The takeaway? Make zero assumptions about what the reader knows - no matter how straightforward the task or concept may be. More advanced users will simply hop over basic details, but less experienced users will run into mountains of difficulty if they’re missing.

Make it Easy to Skim

Making no assumptions about what the reader knows means some of your articles may end up being quite lengthy. And that’s not necessarily a bad thing.

But with 31% of customers expecting instant online help, and 40% of them expect to receive assistance in less than 5 minutes - you want to make it as easy as possible for people to find what they need.

The key with extended articles is to break them up under appropriate headings, subheadings, and bullet points so users don’t feel intimidated by a colossal wall of text.

For example, look at how Shipt splits up longer-form content to make it more digestible. When initially visiting their knowledge base, you're presented with several popular topics as well as frequently asked questions.

Example of knowledge base article from Shipt

When clicking on one of these FAQs, you're brought to a separate page that's further broken down into subtopics as seen in the screenshot below.

Shipt's knowledge base articles are effective due to breaking content down into smaller pieces

By making use of a variety of headings, spacings, bolded text, and bullet points, the information instantly becomes more approachable.

To do this in your articles:

Once you’ve got a solid structure in place, it’s also wise to add a table of contents with anchor links to allow users to navigate directly to the section they need. This is especially handy for more advanced folk who might want to skip the entry-level stuff.

For example, Zoominfo does an awesome job of making it easy for users to navigate to the relevant section without the need to scroll up and down the page.

Notice how Zoominfo makes it easy to navigate their knowledge base

In short, structuring your articles for skimming increases your KB’s usability, helps users better understand your message, and ultimately resolve their problems faster.

Keep It Succinct

With all this talk about extended articles, it’s important to remember that length is not the goal here, it’s simply an occasional side effect of creating comprehensive guides. The truth is that the more concise you can make your article, the better.

Think about it: if your customer is trying to get themselves out of a jam, they don’t want to sift through mountains of superfluous information. Instead, they want the relevant knowledge they need to solve their problem, and not one word more.

That means you must become a ruthless editor. Strive to eliminate unnecessary information that doesn’t add to the issue at hand. Shorten your intros. Chop wordy paragraphs down to size. As a rule of thumb, if you’re unsure if something is relevant or not, it probably isn’t.

Where appropriate, make use of media for greater clarity too. Screenshots & GIFs can go a long way to helping users absorb information more quickly when deployed alongside text. Giphy Capture and LightShot for Chrome are two great tools to accomplish this.

However, be careful using video for solving problems or errors. While videos are good for general overviews and introductions - they’re not as capable of zeroing in on the specifics that your customer is looking for. People in a rush will be forced to watch an entire video to get the one nugget of wisdom they needed.

If you do use video, make sure to timestamp it. Plus, include a text version alongside to make it more efficient and consumable for your time-starved users. Remember, keeping things to the point is the name of the game.

Write Plain Titles

Knowledge bases aren’t blogs, so there’s no need to try and hook the reader’s attention. Users are already looking for your help anyway.

Instead, craft simple titles that convey what problem your article addresses. Ask the question: “What would my users search for when looking for this information?” and when answering aim for clarity over creativity.

Keep in mind that people typically search using basic keywords - “how to insert images and videos becomes ‘insert images and videos” - so model your titles around the keyword phrases.

Using active verbs is a good strategy for kicking off the title of your articles. Some examples are:

Alternatively, you can simply state what topic the article is about for example, “Overview: Article Templates”. As long as it’s crystal clear what your article is about, you can’t go too far wrong.

At Helpjuice we keep our knowledge base article titles simple

As you can see from our knowledge base - none of the titles on display are flashy. Instead, they’re clear cut - just the way they should be.

Hone Your Voice

As linguist Steven Pinker points out in his book ‘The Sense of Style’, smart folks often shun simplicity in an attempt to prove their intelligence. However, as Pinker reveals, using flowery language only makes others think they’re poor communicators.

And your knowledge base is the exact same. People won’t be impressed by your high command of the written word if it’s distracting them from getting what they came for.

So, here’s 7 tips to keep things on point:

The ultimate goal is to make your writing engaging, but without allowing your message to become lost amongst a sea of ‘brand personality’ or unnecessarily complex language.

Two tools that can whip your copy into shape are Grammarly (awesome for spell checking and finding better phrasings) and the Hemmingway Editor which will make your writing bold and clear.

Link to Related Content

TCL knowledge base example

So don’t link to every article that’s remotely related to the topic at hand. Instead, use links only when they’ll nudge users towards the next logical piece of content.

( Note : As we'll discuss in the next step, you'll be able to figure out the logical pieces by analyzing data from your knowledge base analytics as well as collecting feedback from your support agents. )

Constantly Improve Your Process

The perfect knowledge base doesn’t exist. All great knowledge bases became that way precisely because they committed to the continuous improvement of their content.

How do they do it? Through data and feedback.

A good knowledge base software will provide analytics that let you discover things like:

Screenshot of analytics from Helpjuice to improve knowledge base articles

Using such information, you can double down on what’s working and ease up on what’s not. Over time, you’ll build a powerful collection of articles that your audience will thank you for.

It’s worth mentioning that the benefits of analytics go beyond just improving your articles. Support data is a great source of insight into how customers are thinking and feeling. That means it can also help you build a better product, refine your sales process, or inform your marketing strategy too. 

Just think about it: if lots of users are searching for “how do I integrate with (insert tool)” you can feed that information back into your dev teams and build a solution that your customers want.

That means that while your writing is giving users a better experience, how they’re interacting with your content is giving your business valuable feedback about how to improve. Talk about a win-win.

Examples of Excellent Knowledge Base Articles

Okay, now that you have an idea on how to write effective articles that will support your end-users, let's look at some great knowledge base examples from real companies to see how they are implementing these same practices. 

Visual Overview of the HootSuite Dashboard (@Hootsuite)

writing knowledge articles

Hootsuite’s guide on how to use their dashboard is a perfect example of how to ace a knowledge base article. A short introduction leads into a video overview of the topic which is supported by a well thought out article beneath. Complete with screenshots and handy links for more information makes learning the dashboard features a breeze.

McAfee WebAdvisor Blocking RMS Reports (@RMS Cloud)

writing knowledge articles

RMS has created a fantastic page on how to stop McAfee from blocking RMS reports. Notice the skimmable layout, clear step-by-step instructions, large text, and handy visual guide at the end. And does it work? Well, with lots of articles like this, RMS cloud has been able to resolve 50-75% of their day to day support requests via their knowledge base.

Conversion Tracking for Websites (@Twitter)

writing knowledge articles

Twitter’s monster article on how to set up conversion tracking is a great example of how to structure longer-form content. The spacing, use of headings, annotated screenshots and ever-present navigation mean users can quickly locate, extract, and implement the knowledge they came for. 

How to Preview & Compare Courses (@Udemy)

writing knowledge articles

The shortest article on the list, but no less impressive, is Udemy’s piece on how to compare and preview courses. It’s simple, to the point, and teaches exactly what its title says. A welcome reminder of the need to keep things concise.

How to Navigate Estimate Rocket (@Estimate Rocket)

writing knowledge articles

Estimate Rocket breaks down exactly how to navigate its SaaS tool in this brilliant article.  Each panel is dissected and explained in plain language with the help of a screenshot so users know exactly what’s being said. The writing is clear and concise, the headings are well spaced out and there’s a link to contact live support in case you didn’t get the answer you were looking for.

Setting Up Your Online Store (@Shopify)

writing knowledge articles

It’s bullet-points galore in Shopify’s ‘setting up your online store’ article which makes getting started with their platform a walk in the park. The use of bolding alongside clear headings is particularly effective to help you skim through the article. And if that wasn’t enough, they included anchor links at the top for maximum efficiency.

How to Make A Collage (@Collage)

writing knowledge articles

Ecommerce company Collage makes it dead easy for their customers to create their own personalized photo collage with this awesome page. It’s a great example of how you don’t need to go overboard with fancy graphics or complicated design. Sometimes it’s better to pair things back and let your help content do what it does best.

Wrapping Up

Writing good knowledge base articles can be a challenge at first. But with practice and a little elbow grease, you’ll soon be whipping up articles that your customers adore.

Start with the easy stuff. Begin writing just a few articles on uncomplicated topics. As you grow in confidence and skills, you’ll be better equipped to tackle complex articles without pulling your hair out.

Like Rome, no great knowledge base was built in a day. So don’t try and rush things. Instead, approach your article writing one step at a time. Focus on quality, stay organized, stay consistent, and stay patient. 

Trust the process and you’ll reap rewards sooner than you think.

More Blog Posts

Enjoyed this article? Check out our favorites

writing knowledge articles

4 Bulletproof UX-Hacks To Skyrocket Your Knowledge Base

writing knowledge articles

6 Simple Tricks to Make Your Knowledge Base Searchable

Case Studies

Our Case Studies

Some of the best case studies to improve your knowledge base

How FlowWright Revolutionized its Documentation Process and Reduced Support Tickets by 30% with Helpjuice

How FlowWright Revolutionized its Documentation Process and Reduced Support ...

This Chat App Reduced Internal Onboarding By An Unbelievable 40%!

This Chat App Reduced Internal Onboarding By An Unbelievable 40%!...

How Helpjuice Helped Royal Dance Conservatory Onboard Employees 2-3 Times Faster

How Helpjuice Helped Royal Dance Conservatory Onboard Employees 2-3 Times Fa...

Start your 14-day free trial.

Join over 1000+ companies already growing with Helpjuice.

Do you want a free Knowledge Base?

We have the #1 Online Knowledge Base Software for instant self-help

10 Best Practices for Creating Knowledge Base Articles

10 Best Practices for Creating Knowledge Base Articles

What is the first reaction of customers when help content doesn’t make sense? 

“What a waste of time! I should have contacted the company directly.”

There is a reason two-thirds of customers prefer self-service before approaching a company’s support staff. Customers think of self-service as the fastest medium to get the help they need. When these hopes are crushed, their belief and inclination towards self-service diminishes. 

And you are back to square one – managing an ever-increasing mountain of tickets. 

It doesn’t feel nice, right? How to ensure that this situation doesn’t arise in the first place? 

Creating a knowledge base that fails to help customers is worse than having no knowledge base at all. So, if you have a knowledge base , better turn it into the best information resource that sweeps customers off their feet. 

Writing knowledge base articles of top-notch quality can set you in the right direction. Explore the top 10 best practices that can take the quality of your knowledge base to the next level. 

But before that, let’s learn where businesses go wrong while writing knowledge base articles. 

Common Mistakes Businesses Make While Creating Knowledge Base Articles

A knowledge base comprises help content, giving content creators a feeling that it is easy to create. In reality, building a knowledge base is as challenging as developing a whole new website . Quality content is a must, but other elements such as design and presentation are equally important.  

In order to create a flawless knowledge base that invites customers to self-resolve issues, here are some common mistakes you must avoid: 

1. Ineffective Search System

A poor search system that doesn’t return accurate results when customers look for answers is a sure-shot way to make them hate your customer service knowledge base . 

2. Large Blocks of Text

Another common mistake is creating lengthy articles that educate less and confuse more. Even high-quality content fails to make sense if not presented in the right format. 

3. Not Focusing on The Design

Design is an important element of a successful knowledge base. Most businesses ignore the design part, thinking that it is a waste of time and effort. The truth is poor design is a turn-off for customers. No matter how information-rich your knowledge base is, it fails to leave a lasting impact if it is not well-designed. 

4. Writing Complicated, Hard-to-Follow Articles

This is a major reason customer, most of the time, do not rely on self-help articles. Since they are difficult to read and understand, such articles do more harm than good. When the content is not easy to follow, customers have no choice but to contact the company through other means. 

These are some basic areas where companies go wrong with their knowledge base content, which ultimately impacts their customer support. 

Let’s now explore some actionable best practices that will help you write knowledge base articles of top quality. 

10 Best Practices to Create Impressive Knowledge Base Articles

The real difference between an average knowledge base and an awesome knowledge base lies in the quality of its articles. 

How customers feel the moment they step into your knowledge base, what value they receive as they navigate through the content, and how quickly their problems are resolved – all this is determined by the quality of your knowledge base content, structure, and other elements. 

Follow these knowledge base article best practices to build solid help content for your external audience – customers and the internal audience – employees. 

Here we go. 

1. Identify the Pain Points of Your Audience

Behind every unhappy customer is a pain point that goes unaddressed.

Identifying these pain points is crucial to crafting content that customers really need. If you create content without knowing what your customers really need, sooner or later, your knowledge base will turn futile. 

Finding the pain points of customers sets you on the right path from the get-go. Start by tracking your support tickets, emails, and calls. Consult with your support agents to find the common questions customers frequently ask. Look at previous customer-agent interactions and visit the community forum to check the questions customers are asking. 

Putting effort and time into research, in the beginning, pays off later. You will have in-depth knowledge about what customers really need, which will help you write the most relevant help articles. 

2. Do Not Assume

Making assumptions while writing knowledge base articles is a big NO. 

Since businesses know their product in and out, they tend to assume the same for their customers, providing only the information they feel is necessary. This can backfire. 

Understand that customers, no matter how familiar they are with your products, need complete information. So, consider them as beginners and create knowledge base content that guides them at every step from start to finish. 

Avoid technical jargon. You know them, but most of your customers may not be familiar with the terms. The best way out here is to explain all technical terms and concepts right where they are used to avoid confusion. 

No matter how simple a term, instruction, or concept might be, ensure that you explain them to the core. While experienced customers might ignore such content, beginners will get stuck if you miss out on crucial information. 

3. Create the Right Blend of Text, Images, & Videos

Showing how something works is always better than simply writing the process. A document full of text is the root cause of customer disengagement. It is easier to get lost in a sea of words and make no sense of what is written. But, when the same text is combined with the right visuals, the customer experience automatically gets better. 

Visuals help you explain products to the core, demonstrate how products work, and show troubleshooting tips in action. When customers read and see what a product is and how it functions, they can grasp the information faster. Also, with visuals, you need fewer words to explain processes. This means fewer words and more impact. 

Every time you explain a feature, talk about a step or add short videos or screenshots so customers can see everything in action. 

HighQ follows a similar approach. Go through its help center, and you will find an image after almost every step.


4. Let the Content Flow Logically

A knowledge base is not a platform to just dump all the information, expecting customers to find help on their own. An out-of-place knowledge base aggravates customer frustration instead of reducing it. That’s because searching for information becomes a pain when articles are not organized logically. 

While writing knowledge base articles, focus on where you are placing them, under which category, and in what order. When information flows smoothly from top to bottom, reaching the right page gets easier for customers. 

Start your knowledge base with a homepage that offers a glimpse of the inside content. Then move on to building broad categories along with their subcategories for each topic. Put the right articles in the right sections to help customers find what they need quickly. 

It’s always better to adopt a chronological approach wherein you start with the easiest concepts and move on to the more complex elements of a product. You can also provide a list of ‘related articles at the end of each article to make the information search seamless. 

Step into the customers’ shoes and figure out how they would want the information to be presented and accordingly work on the knowledge base structure. 

Here is a perfect example of how an ideal knowledge base format looks like.

Unleashed help center

5. Make Your Articles Easy to Search & Skim

People prefer online self-help because it delivers answers faster than any other mode of support. For a self-service knowledge base to stay true to this perception, it should help readers get what they need in not more than a few seconds. 

That is possible when the knowledge base articles are easy to search and skim.

For uninterrupted searches, a Google-like search system is desirable. A robust search mechanism crawls through the document’s content, keywords, table of contents, and more to display the most accurate results, matching the search query. 

As far as content navigation is concerned, a well-structured document with relevant internal linking is key. Give readers a smooth experience by: 

These are some simple hacks to make your knowledge-base articles easy to discover. 

Below is HighQ’s easy-to-skim help center setting the right example for how exactly you should write articles for your knowledge base.

HighQ's easy-to-skim help center setting

6. Create Content in Collaboration With Different Teams

Writing and managing articles single-handedly is not a good practice. It affects not only the quality of the knowledge base but also the speed with which it is developed. 

But when different teams come together to collaborate and share knowledge, the results are bound to be brilliant. While writing knowledge base articles, ensure that the best minds work under one roof and contribute meaningfully to the content creation process. 

For example, while some team members can bring their technical skills to the table and focus on writing product-related articles that are more detail-oriented, the more experienced individuals can take charge of editing and checking the articles for errors. Others can simply manage all activities happening in the knowledge base and keep track of who is working on what. 

This is a streamlined way of writing and managing knowledge base articles without putting the entire load on a single person. 

With ProProfs Knowledge Base , you can assign the roles of – administrator, contributor and editor to users and groups, depending on their knowledge and experience level.

Add user setting

This video sheds light on how to collaborate as a team to build a knowledge base.

7. Check Article Tone & Voice

Customers visit your knowledge base to get rid of their frustration and confusion, not to increase it. Going wrong with the tone and voice destroys all the effort that you put into writing knowledge base articles. That’s precisely why you need to be extra careful of how your articles read and what they convey.

The tone and voice of a knowledge base reflect your brand. While a positive tone, instructional voice, and simple language reflect positivity, a negative tone and voice can immediately put your brand in a bad light.

While working on the tone and voice, the first thing you should know is – what the knowledge base articles are about? Are they about satiating customers’ curiosity regarding how your product works, or are they about fixing product-related problems?

Identify the objective of the knowledge base articles and accordingly tweak the tone.

Don’t be too formal but don’t be too casual as well. Maintain a respectful, friendly, and instructive tone throughout articles. You can use humor when articles are about introducing your product and its features. But this tone doesn’t work so well when explaining the steps to solve a serious issue.

Writing well is important but dressing the content with an appropriate tone and voice is even more important.

8. Create Simple & Straightforward Titles

Article titles are not the places to show your creativity. A knowledge base is a help document where people come to get quick information about a subject. That’s why simple and straightforward titles work well for knowledge base articles.

More than creativity, your knowledge base content strategy should focus on achieving clarity in titles and even in the content.

While writing titles, remember that people use basic keywords or phrases during a search. Build titles around these keywords so customers instantly know what the article is about. Use active voice and action words while writing articles. For example –

All these are action-oriented titles with the basic keywords conveying what’s covered in the article.

Look at LEAP’s knowledge base below. The article titles are not exciting but extremely clear and straightforward – just how they are supposed to be.

Leap knowledge base article example

9. Collect & Act on Feedback

Gathering feedback is an important step you cannot miss while creating knowledge base articles. The purpose here is to understand what customers like and what they don’t, so you can refine the articles accordingly.

Article feedback is a crucial tool to get a glimpse of the ‘what and why’ of your customers’ dislikes.

There are two ways you can collect feedback-

✅ By feedback forms ✅ By creating surveys

Feedback forms have a single question at the end of every article asking readers about whether they found the article helpful or not, with yes and no as answer options. Customers also have the option to give detailed feedback if they are unhappy with the article. This feedback then reaches you via email, so respective teams can take appropriate action on time.

Mimosa Help Article

As far as surveys are concerned, you can add ticket forms and sidebar forms to allow customers to submit a ticket for issues that the knowledge base cannot address. Once your support team gets the tickets, they can provide customers a resolution and, on the side, update the knowledge base articles so that such problems don’t arise in the future.

10. Improve & Update Your Knowledge Base Articles

A knowledge base is a rich information resource that needs to be constantly improved and updated so that it stays relevant for customers. If you write knowledge base articles once and think that your job is over, think again. Over time as your products develop and customer expectations change, these articles will go obsolete, providing no more value to your customers.

You don’t want that, right? 

The secret to always keeping your knowledge base fresh and relevant is to be committed to continuously improving its content.

The best knowledge base tools available in the market comes with built-in analytics, providing AI-powered insights into how your knowledge base articles are performing. Such insights are shown in the form of graphical reports that can be generated daily, weekly, or monthly. The insights give a thorough analysis of:

This and many more insights help you evaluate the knowledge base articles that are ticking all customer expectations and the content that has room for further improvement. Built-in analytics allow you to not only improve your knowledge base content but also eliminate recurring customer problems and build better products.

Follow these knowledge base article best practices to create content customers will thank you for.

Let’s now look at some knowledge base article types and templates to help you start on the right foot.

Knowledge Base Article Types & Templates to Get You Started

Using a standard template is a great way to write top-quality knowledge-base articles while saving time and effort on the side. Templates give a consistent look and feel to a knowledge base and ensure that writers do not have to create everything from scratch.

Depending on the kind of knowledge base articles you are creating – FAQs, troubleshooting articles, How-to articles, etc., you will need appropriate templates. Here are a few knowledge base article examples that might help you.

1. Troubleshooting Articles to Solve Issues

Troubleshooting is about fixing a problem. These articles are mostly focused on offering solutions in a step-by-step way to help customers self-resolve issues. Such articles are to the point and dive straight into the solution without wasting time building a background in the introduction. They simply describe the issue, provide solutions and explain each solution.

step-by-step way to help customers self-resolve issues

2. FAQs to Answer Common Questions

The FAQ page, as we all know, has the common questions that customers frequently ask. These questions can be general or specific, simple or complex, depending on the kind of issues customers have while using your products. FAQs are to-the-point and organized topic-wise, with answers showing as soon as the question is clicked.

Read More: Top 10 FAQ software for Creating Online FAQs

UNLEASHED has done a brilliant job of creating a separate FAQ section in its knowledge base. The FAQs are divided into 5 or 6 categories – Top 10 FAQs, purchase FAQs, inventory FAQs, etc., making it easier for customers to go to a section they are interested in.

Unleashed help article example

3. Guides to Provide Step-by-Step Instructions

Some companies focus on creating how-to articles or guides with the chief objective of teaching customers:

Here is an example of how such articles are written.

HelpQ knowledge base article

First, the topic is briefly explained, followed by instructions on how to perform a task such as using a product. Here the topic is about duplicating files, which is explained in the beginning along with step-by-step instructions.

All Set to Write Knowledge Base Articles? 

Just like how Rome wasn’t built in a day, so are your knowledge base articles.

Perfecting the art of writing amazing knowledge base articles takes time, but once you do, there is no looking back. Creating something perfect in a single day is not possible. So do not have such high expectations. Start small and easy by writing knowledge base articles on simple topics. Gradually, proceed towards complicated topics that require more research and better writing skills.

Follow the knowledge base article best practices given above, and the chances of your efforts bearing fruits will be even higher. Understand your audience’s pain points, do not assume anything, use images and videos in the content, create simple titles, and do not forget to collect feedback on the articles you write.

Trust us, you will get better with every article and soon start getting the results you want.

knowledge base article guide

Copy and paste this snippet to embed this visual

writing knowledge articles

About the author

Brayn Wills

Brayn Wills

Brayn is a knowledge management expert. He has been published in CustomerThink , PointVisible and Apruve . As a customer support specialist at ProProfs, Brayn has been instrumental in building a robust knowledge base and documents that help support executives keep every customer delighted. You can catch up with Brayn on Twitter and LinkedIn .

Related Posts

writing knowledge articles

How to Create a Private Wiki: Complete Guide

writing knowledge articles

How to Create Awesome Internal Documentation: A Complete Guide

writing knowledge articles

8 Steps to Creating Great End User Documentation

writing knowledge articles

How to Create Online User Manuals

Write for us

Popular POSTS

11 Best Knowledge Base Software for 2023

11 Best Knowledge Base Software for 2023

The 20 Best Knowledge Management Software of 2023

The 20 Best Knowledge Management Software of 2023

Knowledge Sharing at the Workplace: How to Improve It

Knowledge Sharing at the Workplace: How to Improve It

Top 15 Knowledge Management Trends to Keep You Ahead of the Curve

Top 15 Knowledge Management Trends to Keep You Ahead of the Curve

How to Create Online FAQs with FAQ Software

How to Create Online FAQs with FAQ Software

10 Best FAQ Software to Provide Top-Notch Customer Support

10 Best FAQ Software to Provide Top-Notch Customer Support

15 Best FAQ Page Examples To Inspire Better Customer Support

15 Best FAQ Page Examples To Inspire Better Customer Support

10 Major Features Your Knowledge Management System Should Have

10 Major Features Your Knowledge Management System Should Have

10 Best Technical Writing Tools of 2023

10 Best Technical Writing Tools of 2023

Top 12 Help Authoring Software Solutions and Tools in 2023

Top 12 Help Authoring Software Solutions and Tools in 2023

The Best 20 Wiki Software For Your Business

The Best 20 Wiki Software For Your Business

20 Best Documentation Software of 2023

20 Best Documentation Software of 2023

Avatar for Username

Search Support

Writing guide for Knowledge Base articles

writing knowledge articles

As a knowledge base contributor, you use words to help half a billion users. That's a big job. Users come to the knowledge base from all over the world, and they expect easy solutions, but we also want to delight them with our voice. How do you do that? Here are some things that we came up with in our research.

Table of Contents

Write with the brand in mind. Mozilla is about user choice. We believe in freedom and flexibility. We value privacy and security. We are a community-driven non-profit with contributors all over the world who share common values.

You don't need to hammer this story in every time you write an article. It's just something to keep in mind when you're describing features.

Writing style

Write for a general, non-technical audience.

We want our articles to be usable by everyone, not just advanced users. This means we're writing for a general audience rather than one very familiar with computer techniques and terminology. Assume the person you're writing for doesn't know how to change preferences or add a toolbar button without step-by-step instructions. Also, we should assume that they haven't changed any of the default application or operating system settings.

To summarize, you should follow these guidelines:

Read the next section for more comprehensive guidelines.

Writing style (comprehensive)

Write a good introduction

Along with the title and the table of contents, the introduction is what people will use to quickly determine if they are in the right place.

A good introduction can usually serve as a good search summary. Often you can just copy it into the "Search result summary" field and you're done.

Organize the article effectively

The general idea here is to try to build skills from simple to complex while trying to keep the information needed by most people near the top. So a simple, common solution would usually come before a complex or edge-case solution.

Use descriptive heading titles

Our articles are usually comprehensive so it's important to use descriptive headings to help people find the part of the article that they need. Take a look at your table of contents. Does it work with the introduction to give you a nice overview of the scope of the article?

Make step-by-step instructions easy to follow

The main thing to keep in mind when writing step-by-step instructions is to be careful to include all the actions needed to complete the task. If, for example, you have to click "OK" after selecting a preference in order to move to the next step, be sure to include clicking "OK" as part of that step. Some additional things to consider:


The text must be readable. To do this, you must:

There is no limit to the amount of text. The more material, the better; however, you should not artificially expand it. Provide only useful, valuable, necessary information.

Technical guidelines

Fix the slug

When you create a title, SUMO will automatically create a slug (the end of the URL for the article). The slug has a 50 character limit. Spaces are rendered as dashes. The slug should be consistent with the title, but given the tighter space restraint, doesn’t need to be the same. Be sure to check the end of the auto-generated slug. Sometimes a word gets cut off or it ends in a dash. Please fix things like that.

Categories, products and topics

For the most part, an article belongs in either the How-to or Troubleshooting category. Occasionally we write "How To Contribute" articles (like this one) or something in one of the other categories.

Articles are also "relevant to" at least one product. They also belong in one main "Topic" and, optionally, a "sub-topic".

The keywords field in an article can be used to improve search results on SUMO. It should be used only under specific circumstances though, as misuse can actually hurt search. We rarely need to use keywords. For details, see When and how to use keywords to improve an article's search ranking .

Write a good search summary

The article summary, along with the title, helps users judge whether an article will answer their question. We call this "User Confidence" and it directly impacts click through rates. Even if we serve the correct article at the top of the search results list, the user needs to make the mental connection between the search query and the results we display in order for them to click through to the article.

A summary for a how-to article should include the topics covered in the article. A troubleshooting article should try to include symptoms. In addition, a summary should follow these guidelines:

Number of steps

Use numbers or bullets to guide users through every step of the process. Whenever possible, try to limit the number of steps required to 6-7.

Parallel structure

Use the same phrasing or pattern of words for every step you write.

Style guide and copy rules

Like we said before, you should use an active, conversational style when you write. Avoid saying things like, "If a user's bookmarks have been lost" and instead say, "If you've lost your bookmarks". Here are other common style and copy issues you may run into when writing support articles:

Always use terms the way they appear in the Mozilla interface. For example:

General computing terms:

Links to should not contain the locale:

Capitalize the following items:

Don't use "i.e." and "e.g." . These Latin abbreviations can confuse people. For the sake of clarity, use "in other words" or "to put it differently" instead of i.e. when you want to explain something in a different way. Use "for instance", "for example" or "such as" instead of e.g. when you want to give examples.

Don't use serial commas in a list of items. For example, use "Extensions, themes and plugins" (without the serial comma), not "Extensions, themes, and plugins".

Use initialisms that are considered to be generally understood. For example:

Numbers appearing in the version of a product, error codes, keys and buttons will not be spelled out.

Write instructions in active voice. The present tense is easier to follow. Example:

"Restart Firefox to update" not "Firefox has to be restarted"

Spell out backslashes(\) and forward slashes(/) for paths and searches to avoid confusion.

Example: "Some pathnames to images contain backslashes (\\)".

Keyboard shortcuts Capitalize the first letter of a keyboard shortcut or combination of shortcuts. Ctrl + Shift + C

Don't use slang and idioms . All of our articles are translated into many different languages, so they are read and translated by non-native English speakers. Slang and idioms can be ambiguous which can confuse readers and make translation more difficult.

We have special visual styles for a number of items that can be achieved by adding the proper wiki markup around the item. See the Markup cheat sheet for the most common styles.

We have a special wiki markup – {for} – that allows you to target information for specific versions of Firefox or specific operating systems. For example, you display one set of instructions to people running Windows and another to people using Mac OS X (see How to use For for details).

Share this article:

Was this article helpful?

These fine people helped write this article:

Illustration of hands

Grow and share your expertise with others. Answer questions and improve our knowledge base.

The Do’s and Don’ts of Writing Knowledge Base Articles

Tomasz Ziętek

If you work on a support team that uses a knowledge base, then creating, sharing, and updating help content is probably your bread and butter. A help article, in order to be effective, needs to tick a few boxes. After all, they are supposed to be a quick solution for customers in search of answers, and a time saver for your customer support team.

Read on for the do's and don'ts of creating knowledge base articles that deliver fast solutions.

What is a knowledge base?

A knowledge base is a collection of organized information and resources. The knowledge inside can range from product manuals, technical support articles, company policies, or FAQs, to onboarding materials, and help articles for customers.

In most cases, you can set up a knowledge base using a knowledge base software which allows easy storage, organization, and the maintenance of knowledge.

It’s particularly popular among online businesses with an online presence where three use cases dominate: 

All in all, a knowledge base software can greatly improve customer experience. On one hand, customers get a better experience, because they can find answers in a help center that's open day and night, so they don't have to experience all the hiccups connected to chatting with an agent. On the other hand, agents can provide customers with comprehensive solutions much faster as all the information is ready-made and close at hand.

If you're looking for an easy way to organize and share your knowledge, try KnowledgeBase . You can use it to create a knowledge base, manage articles, and create both and external help center and internal knowledge base , making it easy for your customers and employees to find the information they need.

A homepage of the knowledge base from Spotify

You can try it for free for 14 days.

What is a knowledge base article and what is it used for?

A knowledge base article is a written document about a specific, business-related topic. It can be connected to a product, a service, a company policy, frequently asked questions, and any other topic worth wider attention.

The purpose of an article is to provide an explanation. It should provide a reader with valuable information, solutions, or tips that fill a knowledge gap.

How to write a good knowledge base article?

Once you have your knowledge base up and running, it is time to fill it up with knowledge. Writing a good knowledge base article is not rocket science, but you need to remember about a few things.

Here are six tips for creating a great knowledge base article.

Know what to write about

Knowledge base articles only make sense only if someone reads them. Writing an article without researching the actual need for it is a waste of time, because it just won’t help anyone.

To avoid such a waste of time, effort, and money, you can delve into the analytics inside your knowledge base software. Most of them usually have a section with top views and top missed queries. There you go. Missed queries are one of the surefire ways to get an idea of a topic that will be of help to your customers.

Use a clear, concise writing style that is easy to understand

When writing knowledge base articles, it's important to keep a concise style that is easy to understand. This means avoiding industry jargon or overly technical language which might be unfamiliar to a reader. It can only result in an unhappy customer. 

It’s best to stick to the ELI5-like explanations. Establish a clear tone of voice and stick to it throughout your all articles. This will keep your knowledge base consistent. 

Make your article readable and scannable 

People on the internet don’t read anymore. They scan. 

This is something you should always keep in mind when writing any content. This requires writers to design their text in a way that is easy to read, or rather scan.

Break up your text with headings, images, videos, or lists. Including visuals can make the article more appealing and easy to scan, improving the overall customer experience.

Avoid lengthy paragraphs. Keep them short and simple. Four or five sentences in a paragraph is fine, but more than this and a reader sees a wall of text. 

Consider including:

When it comes to sentence readability, it’s best to use simple language and short sentences, so a reader can quickly get the gist.

Such a reader-friendly article will help your customers solve their problems faster.

Add related reads

Help your readers get a better understanding of a topic by adding links to additional, extended reads. 

Don’t expect your reader to get acquainted with an entire subject in your article. They just need a quick solution. 

A good way out of this is to give your readers a choice and provide them with links to other relevant reads they might, or might not, find interesting. 

Make sure your article is up-to-date

One important tip for creating a great knowledge base article is to make sure it is always accurate and up-to-date. This not only helps to provide the most useful information to customers, but also reflects well on your brand and customer support team.

Regularly checking for new information related to the topic of the article will ensure that it remains accurate. You can set up a reminder to periodically review the article.

Create a clickable table of contents 

If you’re writing something lengthier, you can still make it readable for a reader. To do so, you should create a clickable table of contents. 

Readers can easily navigate through your text and quickly jump to the part that interests them the most. They don’t have to scan through an entire text to find what they need.

Creating such a table of contents actually also makes sense for shorter articles. It’s always easier to direct a reader to what they need. 

Proofread your work before publishing

Last but not least, it's always important to double check your work before publishing. Ideally, you should have someone else have a look at your text. Some smart and handsome.

This not only ensures your text is grammatically correct, but also helps to improve readability. Another pair of eyes might have additional suggestions for improvements, too.

A refined article reflects positively on your company and improves overall customer satisfaction.

Put knowledge to work

Knowledge base software for lightning-fast customer support and effortless self-service.

Trusted by 2,500+ companies

writing knowledge articles

An example of a knowledge base article

Let's have a look at this help article from Buffer.

A knowledge base article from Buffer about Editing your images

Right from the beginning, we get a title, we see the author, and the date of publication, or the last update. It gives us an impression that Buffer keeps their knowledge base up to date.

Then, there’s a short introduction that clearly explains what the article is about. 

Next, there’s a section for more advanced readers who might prefer editing with Canva and Pablo. Thanks to this section, we can jump to what we need without doing an additional search. 

After this section, we get a clickable table of contents which helps us navigate. It indicates what the article is about and lets us quickly move to the bit that interests us the most. 

The middle part of the knowledge base article from Buffer about editing your images.

The gist of this help article is a step-by-step guide to editing photos in Buffer. Each step is highlighted with a blue design, so it’s easy to follow. `The instructions are brief and supplemented with an image we can zoom in. All of this favors good readability.

The help article also contains notes that give broader explanations of particular functionalities, or a step. 

Notes inside a knowledge base article from Buffer

Buffer’s help articles are readable, informative, and well designed. Don’t hesitate to get inspired by their content. It’s a good example to follow.

How to promote your knowledge base articles?

Publishing your help article is half the battle. 

Now you should make sure that your article is visible and used.

Share it with your team

When it comes to promoting your internal knowledge base articles, make sure all necessary employees have access to the internal knowledge base. Consider reaching out to specific departments or teams that would benefit from an article and share it directly with them. 

Help your customers find what they need

When it comes to sharing your knowledge base articles with customers, there’s a few ways to do so.

Social media

If your business is active on social media, make sure you publish a post that will promote the new publication in your help center.


You can send out a newsletter to your customer base and let them know about a new knowledge base article. 

Homepage of your knowledge base 

Some knowledge bases have a separate “Recently added” section which is a great place to showcase newly released articles.

Are you looking for a knowledge base?

Providing a self-service option for your customers helps to reduce the number of support requests. Your team can focus on more important tasks and doesn’t have to bother with the same questions over and over again.

At the same time, a knowledge base with articles is faster than chatting with support agents. Your customers get instant answers and don’t have to worry about slow response times.

If you don’t already use a knowledge base as part of your customer support strategy, it’s good to consider it now. Check out our KnowledgeBase free trial and see how easy it is to build your knowledge base and write better knowledge base articles.

Share it with the world

Related articles

a customer support agent in front of a computer

10 min read | Dec 06 | Tomasz Ziętek

10 Benefits of Knowledge Base Beyond Customer Service

A knowledge base is one of the most underrated tools not only in customer support but also... read more

A man sitting at a laptop, browsing

14 min read | Sep 23 | Tomasz Ziętek

Building a Knowledge Base in 2023

If you already have the idea of building a knowledge base, you’re halfway there. In this... read more

9 min read | Jul 07 | Piotr Borkowicz and Tomasz Ziętek

[2023] 12 Best Knowledge Base Examples

Back in the day, when customer support teams had to rely on physical binders and folders... read more

Help your customers and support teams at the same time

Empower your support team with an internal knowledge base and a 24/7 customer self-service center.

Free 14-day trial No credit card required 24/7 support

Discover our other products

LiveChat Connect with customers

ChatBot Automate customer service with AI

HelpDesk Support customers with tickets

How to Write a Knowledge Base Article: 9 Easy Steps

writing knowledge articles

Have you ever come across a knowledge base article you couldn’t make heads or tails of? If so, you’ll know that low-quality help content damages the customer experience.

Conversely, well-written knowledge base content is a tried-and-true way to reduce reliance on live agents and help customers get the information they need, instantly.

Let's get started.

What is a knowledge base article?

A knowledge base article is a type of help doc that is designed to either answer frequently asked questions or aid customers with solving problems they commonly run into.

Despite the name, knowledge base articles don't have to be limited to writing, and may also use videos, images, and other media if it helps get the point across.

Types of knowledge base articles

There are a few different types of knowledge base articles you might come across. Some common examples are:

Each one of them demands its own unique structure and approach.

Did you pass knowledge base 101 yet?

Want to know more about knowledge bases and what they can do? Check out our comprehensive guide.

Upgrade your knowledge base

9 steps to create a knowledge base article

1. think of the audience.

One rule of thumb is to assume your readers know nothing, so everything needs to be spelled out and explained. This doesn’t mean you fill articles with extraneous information. If you’re writing an article about how to train a chatbot, you can assume your readers know what a chatbot is . But, while writing about the training process itself, you need to describe the concepts used and steps readers take thoroughly as if they are seeing them for the very first time.

Knowledge base article "Do"

Knowledge base article "Don't"

If explanations unduly increase the length of an article, or over complicate it, use links instead: write a separate smaller article and point the user to that via a clear anchor text.

2. Decide on the type of article

Depending on which article you want to write, you’ll have an initial plan and timeline, and a particular approach to your preparation efforts (see next section). 

The type of article will also affect your structure. Installation and user guides have a strict chronological order, while FAQs may cover anything from the easiest-to-understand concept to the more advanced.

3. Gather knowledge before writing

Clarity of writing comes from clarity of thought. 

Before you start writing:

4. Start from the reason

Begin every knowledge base article by stating the reason you’re writing it – which should match the reason your customers are searching for it. “Reset your password” articles could start with “If you’ve forgotten your password or get the ‘password isn’t correct message’ follow the instructions below to set a new one.”

This will help:

Example of a knowledge base article by Google

5. Allude to the benefits

Knowledge base articles don’t have to be purely utilitarian. If your knowledge base is publicly available online, your knowledge base articles may end up ranking on search engines and getting clicked on by people who aren’t your customers (yet).

There’s no downside to mentioning the benefits for the customer of each product or service you’re describing. Even technical knowledge base articles, like articles explaining the nuts and bolts of SLAs, can have a hint of why SLAs are important to your company and customers.

Example of a knowledge base article by Typeform

6. Make your content easy to skim

A knowledge base article should allow readers to scan the most important points at a single glance. 

That’s because a user might have followed a process correctly but stumbled at one particular point. You want them to be able to find the solution without having to go back over all the information.

It also helps content display properly on mobile, promoting a positive experience across devices.

Here are some key elements to consider:

Example of a knowledge base article by Apple

7. Mind your language

Your choice of words and turn of phrase can make or break an article. 

So, when writing a knowledge base article, here are some rules to remember:

8. Choose informative titles 

Imaginative titles will confuse readers and make knowledge base articles difficult to find. Instead, choose titles that accurately describe the content of the article. Here are some common phrases used in titles of knowledge base articles:

The correct title might be tricky for more complex topics. For example, whether you choose “How our API works” instead of “How to integrate your existing software” depends on what you know about your customers and their queries.

An idea that helps is good ol’ keyword research. Whether via Google Analytics or via an SEO tool like SEMRush or Moz, you can find what users are actually searching for regarding a particular topic.

9. Show don’t tell

It’s fair to say that any person who has tried to navigate software using an article without any visuals has had issues. 

So, consider adding these visuals to a knowledge base article when appropriate:

Example of a knowledge base article by HubSpot

Knowledge base article template

To help you get to grips with writing your knowledge base articles, we’ve created a set of handy templates . You’ll find a range of templates broken down by article type as well as an explanation on how to use them.

writing knowledge articles

A knowledge base article to to be proud of

Make sure you give your customers every chance to get to grips with your knowledge base articles. For example, a customer service agent can link to them directly from live chat and you can also fit them seamlessly into chatbot interactions to create comprehensive 24/7 self-service support .

And remember: don’t get complacent; gather feedback (e.g. via CSAT surveys that pop up in your knowledge base), adjust and refine. After all, your knowledge base works only if your customers think it does.


Easily build knowledge bases that have all the answers

Learn More >

Do you have any other tips for writing knowledge base articles? Let us know in the comments.

Related Articles

The Whatfix Blog | Drive Digital Adoption

How to Write Helpful Knowledge Base Articles (+Examples)

Levi Olmstead

How easily and how quickly can a customer solve a problem they’re facing with your product or service? When a customer hits a dead end while using a product, the first thing they may interact with is your company’s knowledge base . 

With over 40% of consumers now preferring self-service over human contact , it’s become imperative for businesses to write in-depth, helpful knowledge base articles that empower customers with the documentation, guidance, and support to solve their own problems. 

We’ve compiled a comprehensive list of knowledge base best practices to make this process easy for you. But before we dive deeper into how to write a knowledge base article, let’s look at what it means and why it is an important tool for improving your customer experience.

What Is a Knowledge Base Article?

A knowledge base article is designed to be helpful documentation and tutorial content that can be found and use by customers to solve common questions and problems in a self-sufficent way. A knowledge base article features guides, videos, infographics, GIFs, and other visual aids that help your customers get the most out of your product or service.

A well-crafted knowledge base consists of dozens of articles that empower your customers with the knowledge and tools to resolve their issues without needing to contact customer service.

What’s the Purpose of a Knowledge Base Article?

A knowledge base article is a cost-effective way to help your customer find an answer to common questions in a helpful way, without the need to submit a support ticket or send an email. This ultimately helps you meet the gold standard for a high-quality, simple, and helpful customer experience. 


The main purposes of a knowledge base and its supporting articles include:

Having an effective knowledge base in place empowers your team to focus its time and energy on more pressing matters. In addition to the above use cases, a knowledge base helps you: 

15 Best Knowledge Base Examples in 2022

18 Best Examples of Helpful FAQ Pages (+How to Create Your Own)

15 Best Knowledge Base Software in 2023

5 Components of a Helpful Knowledge Base Article

An effective knowledge base article is informative, engaging, easy to navigate, and unquestionably straightforward. Remember, the article is all about delivering valuable, easy-to-digest information to customers, prospects, and potentially even employees. 

Let’s look at some of the key components of a well-written knowledge base article.

1. Clear, simple writing

Use simplified language. It’s sometimes hard to explain a complex problem. But using simple, clear language to show complex thoughts is the best way to help your audience. 

Writing sentence with non-common and complex words is the last thing you want to do in a knowledge base article. Take the time to edit your article. Be aggressive in cutting unnecessary copy and material.

2. Visual content such as screenshots and graphics

Embedding graphics and screenshots in your knowledge base articles is a crucial step. Your customers will thank you for including graphics and screenshots as opposed to a page of black and white text. 

Using a mix of written copy and visuals to help guide users through your products and services provides more context, is more inclusive to different types of learners and provides overall more support. 


Usually, simple screenshots with annotations are perfectly fine – there is no need for heavily branded screenshots or over-the-top graphics. 

Here’s a simple example of how Apple helps its new customers learn to take screenshots:


3. Videos and GIFs

Adding video to your knowledge base articles is the perfect way to deliver faster, more contextual, and effective support content to your customers. Embedding videos help explain complex steps in less time. 

Let’s consider a complex process that many people have trouble executing, tying a tie.

If you’re reading a help article on how to tie a tie, an already tough-to-master process can seem even more complex. Instead, a quick 10-second GIF brings together the entire process into a short, more helpful explanation guide that adds more value than a long-form article.

4. Jump links and page navigation

Structuring your knowledge base articles is the difference between providing actual helpful support or coming off as confusing. 

Chances are that most of your customers are coming to your knowledge base stressed and annoyed. We recommend taking the time to keep your article as intuitive as possible. 

How do you do that?

Introduce jump links and page navigation elements into your knowledge base article. Here’s a quick run-through of how Whatfix segregates topics to help customers navigate through its knowledge base.


You can see that at Whatfix, we not only include left-side navigation that adds context to where the individual knowledge base article fits into the overall knowledge base – which provides related support content – but also a table of contents for the individual support articles you’re on.

This allows readers to quickly jump through the article and find the exact answer to a contextual issue they’re encountering.

You should also use headers, bulleted lists, shadow boxes, and other visual elements to provide structure, organization, and simple navigation to help draw your readers’ attention to the right spots of the article.


5. Simple article titles and tagging structure

Simple titles and tags help your customers find the right articles that have the answers they are looking for. 

Focus on writing simple and understandable titles. Look at what organic search your customers have made in the past and confer with your support team on some of the most asked questions to make this process easier. We highly recommend using action words like ‘how to’ and ‘using’ and leverage a keyword research tool such as Ahrefs to help with this process.


You should also tag each article with appropriate keywords to help organize your knowledge base content and make it more SEO-friendly. For example, tag all your knowledge base articles that cover account management topics – ie. updating billing, updating passwords, adding new seats – with a tag of “account management”.

8 Tips to Write Effective Knowledge Base Articles

Your knowledge base articles should make it easy as possible to find answers. It’s important that your knowledge base is formatted in a way that makes solutions clear and obvious. 

These eight tips will help you to write more effective knowledge base articles

1. Know your audience

Knowing your audience is the ultimate key to developing an effective knowledge base and writing knowledge base articles. 

Learning your audience’s technical understanding or preferred form of learning allows you to fully cater to their needs. As a rule of thumb, you should already have a solid understanding of your customer personas and their related behaviors. 

Ask your support team to create a list of customer questions they spend the most time on. Then, begin to write knowledge base articles based upon those common questions. This will help you provide a higher level of customer support, create a helpful knowledge base, and reduce the number of support tickets coming in.

2. Don’t make assumptions

Remember, most of your customers do not know the product as well as your internal stakeholders do. Put yourself in your customers’ shoes and rethink the assumptions you make while writing the article. 

For instance, do not use complex language, technical jargon, or internal lingo in your article. Assume that most of the customers are novice beginners. We recommend over-communicating even “simple” instructions.

3. Organize your content with headers and subheaders

This goes without saying but we’d be more than happy to lay it out for you. Organizing your knowledge base content is a critical step in ensuring customers find what they are looking for. 

For instance, including a table of content makes it easier for users to skip past the information they don’t need and navigate directly to the details they’re looking for.


Don’t forget to keep your headers and subheaders simple, as well as write and format them in an SEO-friendly way to help pull in long-tail keywords from Google and other search engines.

4. Use anchor links

As discussed earlier, include anchor links in your knowledge base articles. Anchor links are web page elements that allow users to jump to another location on the same page. It guides your customers to the desired information in a matter of seconds and significantly improves the user experience.


5. Create easy-to-read, skimmable articles

Imagine you are looking for a quick fix to your email scheduling issues within your new email marketing software’s knowledge base. You start looking for an answer to this issue, but become buried in text-heavy documentation that includes tons of information that is not contextual.

Knowledge base articles are usually quite long to begin with, but it’s essential to ensure that you don’t intimidate readers with a wall of text. Introduce bullets, tables, and a variety of formatting elements to ensure your articles are skimmable and easy to read.

6. Use multimedia such as video, images, and GIFs

A sure-fire way to improve the effectiveness of your knowledge base article is to include multimedia content such as videos, images, GIFs, infographics, and animations. No matter how ‘good’ your writing is, it will most likely be overlooked without visuals.

7. Write straightforward titles

As discussed earlier, writing straightforward titles helps you summarize what your article is actually about. Refrain from getting too creative with the title, instead write simple search-optimized titles. 

This will help direct readers to the answers they’re searching for – and will help your content appear in search results, providing more visibility for those searching for answers.


8. Create SEO-friendly articles

Try leveraging keyword research tools such Ahrefs and Semrush to keep your content SEO-friendly. These tools will give you insights into what your customers and users are searching for in relation to your support questions. It will also help you understand what types of queries are most commonly searched, helping you to plan new knowledge base articles.

Below you can see examples of potential knowledge base articles that Microsoft could write on MS Teams, based upon keyword research from Ahrefs:


Examples of Helpful Knowledge Base Articles

Here are a few examples of brands that have perfected the art of writing knowledge base articles to get you started:

1. HubSpot's knowledge base articles

HubSpot has an in-depth knowledge base that breaks down common support questions into helpful how-to articles. For example, let’s look at this knowledge base article on how to connect your domain to Hubspot .

Why is this knowledge base article example from HubSpot so helpful?

2. Apple's knowledge base articles

Apple is known for its incredible simple branding, user interface, and customer support. It’s knowledge base articles are no different. For this example, we’re look at Apple’s knowledge base article on how to set up your iPhone .

Why is this knowledge base article example from Apple so helpful?

3. Microsoft's knowledge base articles

Microsoft has customers that span the globe and include various industries and business sizes. Many of its customers are enterprise-level, and contracts of that size require attention to detail and next-level customer support. For this example, we’ll examine Microsoft’s knowledge base article on how to download and install Office 365 .

Why is this knowledge base article example from Microsoft so helpful?

As customer expectations change, so does the need for your company to offer higher levels of customer support. 

With a digital adoption platform (DAP) such as Whatfix, customer-facing teams are empowered to create in-app support content that showcases how-to instructions, task lists, smart tips, and knowledge bases, all embedded directly inside their applications. This allows customers and users to learn by doing and provides on-demand support that empowers customers to find answers to their problems without leaving the application itself.

Whatfix also captures behavioral data, allowing organizations to identify the most commonly searched support queries to identify what new knowledge base articles should be written, as well as to understand what features are (and aren’t) being used.

See how Whatfix’s on-demand support is changing the way organizations onboarding, train, and provide support to their customers with in-app guidance for learning in the moment of need.


Request a demo to see how Whatfix empowers organizations to improve end-user adoption and provide on-demand customer support


Thank you for subscribing!


  1. How to Write a Knowledge Base Article

    writing knowledge articles

  2. How to write effective knowledge base articles?

    writing knowledge articles

  3. An Easy Guide to Writing Effective Knowledge Base Articles [+ Templates]

    writing knowledge articles

  4. Knowledge Writing Macro stock image. Image of stitching

    writing knowledge articles

  5. Developing knowledge articles

    writing knowledge articles

  6. Writing an Effective Knowledge Base Article

    writing knowledge articles


  1. How to read ANY article online for free…

  2. Articles Written Review


  4. An Overview of Articles

  5. writing an article

  6. Articles for beginners


  1. What Was Article 48?

    Article 48 was an amendment to the Weimar Constitution that allowed the president of the Weimar Republic in Germany to work around Parliament to carry out duties that protected the people in times of crisis.

  2. What Is Subjective Writing?

    Subjective writing is a style of writing that is based on the writer’s own personal opinions. This includes the writer’s point of view, judgments or interpretations.

  3. 10 Great Essay Writing Tips

    Knowing how to write a college essay is a useful skill for anyone who plans to go to college. Most colleges and universities ask you to submit a writing sample with your application. As a student, you’ll also write essays in your courses.

  4. 9 Simple Hacks to Write Better Knowledge Base Articles

    9 Simple Hacks to Write Better Knowledge Base Articles · 1. Ask the right questions · 2. Pick one idea per article · 3. Talk with subject matter experts · 4. Use

  5. Tips & Templates for Writing Great Knowledge Base Articles

    8 best practices for writing effective knowledge base articles · 1. Don't make assumptions · 2. Use anchor links in lengthy articles · 3. Make the

  6. A Complete Guide To Knowledge Base Articles

    A good knowledge base article needs to keep things simple. It needs to speak to a range of different people from complete novices to techies and experts. It

  7. An Easy Guide to Writing Effective Knowledge Base Articles [+

    How to Write a Knowledge Base Article · 1. Select simple titles using target keywords. · 2. Only have one article per specific topic. · 3.

  8. How to Write an Effective Knowledge Base Article

    Your checklist for writing a knowledge base article · Determine the topics that you need to cover · Structure the articles in an easily consumable

  9. How to Write Effective Knowledge Base Articles [With Examples]

    How to Write Effective Knowledge Base Articles · Understand User Pain Points · Assume Reader's Know Nothing · Make it Easy to Skim · Keep It

  10. 10 Best Practices for Creating Knowledge Base Articles

    While writing knowledge base articles, focus on where you are placing them, under which category, and in what order. When information flows

  11. Writing guide for Knowledge Base articles

    Writing style · Keep it short. People come to the knowledge base looking for quick solutions. · Keep it clear. Avoid jargon. · Be friendly, fun and empathetic. (In

  12. The Do's and Don'ts of Writing Knowledge Base Articles

    How to write a good knowledge base article? · Know what to write about · Use a clear, concise writing style that is easy to understand · Make your

  13. How to Write a Knowledge Base Article: 9 Easy Steps

    9 steps to create a knowledge base article · 1. Think of the audience · 2. Decide on the type of article · 3. Gather knowledge before writing · 4.

  14. How to Write Helpful Knowledge Base Articles (+Examples)

    8 Tips to Write Effective Knowledge Base Articles · 1. Know your audience · 2. Don't make assumptions · 3. Organize your content with headers and