[ Web Proxy ]
URL:
Viewing: https://www.salesforce.com/ca/service/knowledge-base/article/ [Back]  [Original]

How You Can Write a Good Knowledge Base Article | Salesforce CA
[]

How You Can Write a Good Knowledge Base Article

An effective knowledge base article is clear, engaging, and helpful. Heres how to write one (with some help from AI) that your customers will love.

Christina Keohane , Sr. Product Marketing Manager, Salesforce

September 12, 2025
[]
[]

Great customer service doesnt always involve an agent. Weve found that 61% of customers prefer self-service tools for simple questions and service issues.

Your customers can easily get the answers they need with knowledge base articles, which are informative help articles on your site. They can find what they need at any time (even at 3 a.m.), which frees up agents to focus on more complex service requests.

Service agents can also use knowledge base articles to solve customer problems and reduce their average handle time.

This article will tell you everything you need to know about creating a knowledge base article. Youll learn what a knowledge article is, why theyre important, what to include when youre writing, and tips and tricks (like generative AI) to help you get started.

Prepare your org for Agentforce

Want to get the most out of digital labour? Our exclusive guide covers the best practices you need to know.

What is a knowledge base article?

A knowledge base article is a web page that answers a frequently asked question, troubleshoots a problem, or helps your customers use your products and services. They often include written directions and responses, but can also include images, videos, links, and other multimedia elements.

Knowledge base articles typically live within a central place on a companys website or platform this could be a help centre, FAQ page, or a support portal. This hub should make it easy for your customers to find the answers theyre looking for.

While the structure of this hub will vary based on the needs of your business and your customers, it should have a search function, article tags based on your offerings, and titles that make it clear what the article is about.

If your contact centre has a chatbot, it can surface information from knowledge articles in response to a customer message. Very soon, chatbots with generative AI technology will be able to answer service questions and give better, more personalised responses by pulling from the knowledge base.

Why are knowledge base articles important?

Here are the top three reasons why knowledge base articles are important to your business:

  • Providing a better service experience: Customers are 10x more likely to use self-service than contacting a service centre directly. Having a knowledge hub where your customers can easily find answers gives them the service experience they want and allows them to get service 24/7.
  • Reduce caseload on your contact centre: As more customers solve their problems independently, fewer cases require agent support. This frees up agents to focus on solving more complex customer issues and reduces overall contact centre caseload.
  • Cut down average handle time: As agents solve unique cases and formalise institutional knowledge into articles, more agents can use that information to solve their cases faster and reduce average handle time. Research shows that using knowledge base articles can result in 33% faster resolution .

How to write a knowledge base article

This section will walk you through the important steps to take before writing a knowledge base article, which elements to include, and some helpful tips to make it even easier to write a knowledge article.

Before writing a knowledge article

There are a few steps you want to take ahead of writing your article the first is figuring out which topic to write about.

Consider these three questions when identifying the right topic for your article:

  • What are the most common questions you get service requests for?
  • What are the most common issues your customers need help with?
  • What information would help your customers get the most out of your products and services?

Once youve identified the most common issues, make sure you dont already have a knowledge article about this topic. If an article already exists, decide if it needs to be edited to add updated information.

If no article exists on that topic yet, its time to start writing!

4 components of a good knowledge base article

  • A clear title: Let your customer know what your article will cover in the title. Ensure that the headline is clear, concise, and accurately describes the content within the article. This also makes the article easier to find.
  • Bulleted lists or subheadings: Make your knowledge article easy to skim so your customers dont need to read every word to find what they need. Create bulleted lists or subheadings that show whats covered in each section. If youre writing a tutorial, write step-by-step instructions including which buttons or menu items to click and put them in chronological order.
  • Images, links, or videos: Give your customers as much detail as you can so that they can successfully solve the issue on their own. Add screenshots, images, links to other articles, or videos to your article to help them.
  • Simple language: Write in a way that can be easily understood by everyone. Do your best to avoid jargon that specifically relates to your product and service. Your customers wont have as much product knowledge as you, so use simple language in each step of your article.
Reimagine your contact centre as a revenue generator

From AI to to case management, this is an insiders guide to tools, trends, and tactics making the difference for contact centres.

What a complete knowledge base article looks like

Heres an example of a knowledge base article we created for a fictional payment software, called ZapPay. This knowledge article would help ZapPay customers link their bank account to their ZapPay account.

Connect your bank account to your ZapPay account

Overview

  • Find out how to connect your ZapPay account to your bank account to send money, pay bills, and transfer ZapCash into your bank account.

TIP: Make sure you have your bank account and routing numbers handy before you start this process.

  1. Log in to your ZapPay account.
  2. From the dashboard, tap your name and then click Profile.
  3. Select Connect Bank Account.
  4. From there, a pop-up window will show up on your screen.
  5. Input your bank account number in the text box labelled Account number and your routing number in the text box labelled Routing number.
  6. Double-check that your details are correct before moving forward.
  7. Once youre done, select Save.
  8. Within 24 hours, youll see a ZapPay withdrawal of ten pence or less come through your account and then a refund for that same amount shortly after. This is to ensure that you can successfully withdraw and deposit money between your ZapPay account and your bank account.

Congratulations! Youve successfully connected your ZapPay to your bank account! If you need any additional help, see the links below:

  • Add money into my ZapPay account
  • Transfer money from ZapPay into my bank account
  • Disconnect bank account
  • Add credit card to ZapPay account

3 simple tips to get started with knowledge base articles (hint: AI)

Now that youve got what you need to write the perfect knowledge base article, heres how you can get started.

  • Pull information from old case logs and notes to ensure that youre including as much detail as possible and that youre following the same steps to get a resolution.
  • To ensure accuracy and readability, work with a manager to set up a knowledge article approval process. This will ensure that grammar and spelling are correct, that the information is accurate, and that article formatting is uniform across the hub.
  • Connect a generative AI tool to your service console and have it create the first draft of your knowledge article based on conversation details and CRM data for your experienced agents to review. This will save you time and help you get your articles out faster.

Now you know what a knowledge base article is and why theyre important for both customers and agents. Start writing articles today to give them both an awesome service experience and increase the efficiency of your contact centre.

Unlock the power of self-service

Are you providing your customers with an easy, efficient, and effective self-service experience? Take this quick online assessment to find out what youre doing well and what you need to improve.

Knowledge Base Article FAQs

What are the key elements of a good knowledge base article?

The key elements of a good knowledge base article are a clear title, an easy-to-follow structure, concise language, step-by-step instructions, helpful visuals like screenshots or videos, and search-friendly keywords.

What are the benefits of a knowledge base article?

The benefits of a knowledge base article include giving customers quick answers, reducing support tickets, improving self-service, ensuring consistent and accurate information, and helping support reps resolve issues faster.

What is an example of a knowledge base article?

An example of a knowledge base article is How to Update Your Billing Information, which walks customers through step-by-step instructions, includes screenshots of the account settings page, and offers troubleshooting tips if the update doesnt go through.

What are some common challenges with knowledge base articles?

Common challenges with knowledge base articles include keeping content accurate and up to date, writing in clear and simple language, making articles easy to find, ensuring consistent formatting, adding enough detail without overwhelming readers, and encouraging regular use by both customers and employees.

What is the purpose of a knowledge base article?

The purpose of a knowledge base article is to provide clear, step-by-step information that helps users answer questions, solve problems, or learn how to use a product or service on their own, reducing support requests and improving the overall customer experience.


Web Proxy Viewer  |  New URL  |  Original Page