1-800-VIRTEVA     info@virteva.com        

The Virteva Blog

Trends in service and how they're shaping our industry.

All Posts

How to be a Knowledge Superhero: Writing Effective Knowledge Base Articles

Garbage in = Garbage out. Love or hate the saying, it rings true, especially when it comes to your Knowledge Base articles.


As a Lead Analyst in Quality Management at Virteva, I’ve invested extensive amounts of time and effort to improve our Knowledge and develop best practices and am more than excited to share some tips to make your Knowledge Base more effective, turning you into a Knowledge superhero at your company.


Here are 5 things you should implement into your Knowledge Strategy right away:


1. Consistency is paramount

Consistency is one of the most critical factors when it comes to an effective Knowledge Base. Even more so if your organization works with end-users from multiple clients or are expected to support a wide range of applications.


Your analysts likely won’t be an expert on every piece of technology that every end-user calling in is using. By standardizing your articles so each one follows the same outline, process, and structure, you’re making it substantially easier for your analysts to work on the fly.


Here at Virteva, we utilize a 2-column table format with topics/issues in the left-hand column and troubleshooting content and info in the right. The Knowledge article editor in ServiceNow allows us to easily and consistently format each article using templates and a multitude of tools. Below is an example of the template we utilize for each standard Knowledge article.

planning a knowledge base article, Virteva IT solutions

The actual format of the article doesn’t really matter as long as every article is consistent with the standardized format of your choosing. Take some time to research and determine the format that will work best for your specific situation and reader.



2. Base your articles around the symptoms, not the solutions

When a user calls in, they’re going to describe the issue they’re having. This is typically something like, “My monitor won’t turn on.” Then, your analysts are going to start searching for those symptoms in the Knowledge Base. If your articles aren’t written to be found based on these symptoms, it will be difficult for your analysts to get the right information quickly.


For example, we had a customer who was having issues with their docking stations – they didn’t recognize the monitor when a laptop was logged in. Because the issue was with the docking station, not the monitor, we initially named the article “Docking Station Support.” But when users were calling in for this problem, they would tell our analysts that their monitor wouldn’t turn on. So our people would search for monitor-related terms, and the article they needed wasn’t showing up.


Once we recognized this issue, we renamed the article to “Monitor/Docking Station Sync Issue.” This made it much ­­­­­easier for our analysts to find because it was written using the same language that the caller used.


Ready to reduce your incident volume by 50%?

Click here to check out our Self-Service Implementation White Paper


3. The little things matter. Yes, even formatting.

Being detail-oriented as a knowledge or QA manager is critical; the little things really do matter. Things like consistent and intentional use of font, size, and formatting throughout your entire Knowledge Base can impact your First Call Resolution (FCR) and Average Talk Time (ATT) stats.


Here at Virteva, we are very intentional with our formatting. Our standard is to use:

  1. Bold for buttons or selections the analyst needs to click
  2. Italics for any URL, email, or search terms
  3. Red means the item is imperative to the process
  4. Blue items are side notes that are useful but not critical to the process


4. Never Make Assumptions

Assuming a step is so obvious it doesn’t need to be stated is a great way to let mistakes happen. When writing or updating your articles, you need to document every detail and every step that needs to be taken, even if it’s something your analysts do 100 times a day.


Not only will this help new analysts learn and understand the right process, but it will help prevent more tenured employees from accidentally skipping a step or cutting corners when they’re in a rush.


There is a point to be made about efficiency with this tip. Pay attention to the flow of the article when adding details, as it can very easily become a confusing mess if you’re not careful. Put yourself in the shoes of an analyst and read the article as if you were attempting to troubleshoot the issue yourself. If you encounter any hang-ups or messy portions, clean it up by making the sure the phrasing is concise and minimizing the “busy-ness” of the content.


You can also try reading it out loud, or having a colleague read it. Just because a sentence makes sense in your head, doesn’t mean there’s not another way to interpret it. So getting another set of eyes or ears on it will help identify any potentially ambiguous directions or catch errors or any missing information.



5. Keep Your Knowledge Base Articles Updated

You don’t need to block off massive chunks of time once a quarter or once a year to ensure your articles are up-to-date. You can use your ITSM platform to remind you when individual articles are at risk of getting stale, and you can build that review into your daily continuous improvement efforts.


Our ITSM platform, ServiceNow, is the perfect tool for this job as it allows us to set an “expiration date” on every article. You can set this date manually or set it to a default to ensure its review is consistent.


When the expiration date is reached, a Feedback ticket will be created for the article and an email will be sent to all applicable persons advising them to review the article and update if necessary.


managing knowledge articles, Virteva IT solutions

One Client’s Story

One of our clients, a food company with around 2,000 employees, leverages our Managed Services platform. When we first on-boarded them, their FCR was around 30% - well below our average. I dug into this problem to see why the numbers were so low and I realized that their articles broke every best practice I’ve listed above.

I took the time to update everything. This included standardizing the formatting, fixing typos, reorganizing content to ensure good readability, and making the titles both consistent and based on the symptoms. This was not a small undertaking, but it was critical to improving their FCR and giving them the amazing experience the rest of our customers have come to expect.


Once this project was complete, we saw an almost immediate increase in their FCR from 30% to 60% and have seen steady improvements ever since.


So, Where Do You Start?

If you are looking to improve your FCR and ATT, or if you’ve noticed that your analysts are having a difficult time finding and navigating articles, it might be time to revisit your Knowledge Strategy. It’s well worth the effort it may take to update and standardize every article.


I know, this can be a big project. But if you aren’t sure where to start, our ITSM consultants have helped clients kickstart these types of projects by making it a leadership opportunity for analysts. This gives your team a sense of ownership over the Knowledge Base, fosters a culture of employee development, and divides the workload so it’s not all dropped on one person.


Your Knowledge Base can do more than make your analysts more efficient. If built out properly, it can allow you to expand on your Service Portal, increase self-service adoption, and reduce the amount of tickets that come across your IT Help Desk.

WhatNOW Graphic


Watch our on-demand webinar, WhatNOW Part2: Building Your Service Portal for more information, including ways to leverage your data to design your portal and populate your Knowledge Base, tips for analyzing and maintaining your Service Portal, and best practices for driving adoption.

Watch On-Demand
Ryan Hipsher
Ryan Hipsher
Ryan Hipsher is a Quality Management Analyst at Virteva.

Related Posts

YOUR Top 6 Reasons to Attend ServiceNow's Knowledge 2019 Conference

Around this time each year, we do a blog post about what we’re most looking forward to at ServiceNow’s Knowledge each spring. This year we changed it up, opening the question to all of you fellow ServiceNow enthusiasts to see what everyone else is looking forward to. (Hopefully you all saw our Tales from the Trail contest!)

Slicing the Watermelon: Why Customer Effort Matters at the IT Service Desk

  Bob is a manager of an IT service desk at a large company, and he has just run his performance dashboards for the month. They are completely green because he met the KPI goals he had set out for his employees. Go Bob!    As he enters the printer room near his office on the seventh floor, he runs into Levi for the fifth time today. Levi’s a millennial that works on the first floor.     “What are you doing up here, Levi?”     “Using the printer. The one on the first floor isn’t working.”    “So you walk all the way up here?”    “Yup. I sent some emails to the service desk but didn’t hear anything.”    “Did you try calling?”    “I avoid the phone like the plague. I’d rather climb some stairs than make a phone call.”    Back at his desk, Bob looks at his dashboards, now feeling that they are misleading. Levi would rather climb 7 flights of stairs multiple times a day than talk to the service desk!     Clearly, feedback on the ground, or on the seventh floor as the case may be, wasn’t matching Bob’s green dashboard.    Bob was experiencing “Watermelon Metrics.” The numbers and the dashboards all look green, but if Bob dug a little deeper, he would discover that, despite the green shell, experiences that could only be classified as “red” lurked beneath.    If you have green dashboards but are still hearing rumblings that your customers or end-users are unhappy, perhaps you have a watermelon on your hands. We want to share Bob’s experience to help you build your own roadmap to improve customer service.     It’s time to slice that watermelon!    

ServiceNow Madrid: 5 Features Not to Miss

ServiceNow is moving 1749 kilometers to the south from London to Madrid in the coming months. And with the new ServiceNow Madrid release comes everyone’s list of expectations and what to watch out for.