{"id":20596,"date":"2024-01-18T10:36:44","date_gmt":"2024-01-18T10:36:44","guid":{"rendered":"https:\/\/www.topdesk.com\/en\/?p=20596"},"modified":"2025-05-20T12:28:15","modified_gmt":"2025-05-20T11:28:15","slug":"writing-better-knowledge-base-articles","status":"publish","type":"post","link":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/","title":{"rendered":"Writing better Knowledge Base Articles"},"content":{"rendered":"

So often, the problem with knowledge bases is that they are hard to understand. Either the knowledge articles do contain the knowledge and it\u2019s just not communicated that well, or the knowledge base is hard to coordinate. So what do you do? Learn how to write good knowledge base articles here.<\/p>\n

What is a good length for a knowledge base article?<\/h2>\n

No one wants to read a 50 page manual. Make sure your knowledge base articles<\/a> are as short and to the point as you can make them. A good rule of thumb is that the article should fit \u201cabove the fold\u201d. That is to say, you should never have to scroll to read the article.<\/p>\n

But be pragmatic. If you need to fit more information, you should. And if everything you need to say is best summarized in three sentences, then let the whole article be three sentences.<\/p>\n

Focus on the context of the query in your knowledge base article<\/h3>\n

We always recommend speaking the language of your end users instead of industry jargon as much as possible. It helps them navigate Self-Service Portals<\/a> better, and it makes sure they feel like you and them are on the same page. Similarly, it helps them understand your knowledge base articles easier.<\/p>\n

The important thing to understand here is you should focus on a solution to the context of the users situation. Not explaining the error codes and how to deal with them. Phrase the problem in a way the user understands \u201cPrinter is not working\u201d rather than \u201cprinter shows error code 330219\u201d. Bring in technical things like error codes and serial numbers only if you definitely need to.<\/p>\n

Make sure your users find the knowledge base articles<\/h3>\n

And along the same lines \u2013 make sure your users can find your knowledge articles. A great thing to do, especially if you have a search functionality in your knowledge base, is to phrase your articles as questions.<\/p>\n

This is because people tend to phrase their queries (for example on Google) as questions when they want to find something out. It\u2019s a fun human quirk in how we interact with technology, but one you can put to good use!<\/p>\n

Put yourself in the shoes of a user who has the specific problem of what you are writing a knowledge base article for. How would they phrase the question? What keywords would they use? Maybe they would just type \u201cI cannot log in\u201d \u2013 then title your knowledge base article just that<\/strong>.<\/p>\n

If you have access to search history data in your knowledge base, you can have even have a look and see what the most common phrasings of a certain query are \u2013 and how often it crops up.<\/p>\n

Consider different levels of experience in solving problems<\/h3>\n

One good thing to do is to also let your users know what is required from them to solve a problem themselves<\/a>. A way to do this is to have an indicator at the top of the page that tells the reader how in-depth the procedure is. This could be either a numerical 1-5 type value, or a plain text \u201cintermediate\u201d or \u201ceasy\u201d.<\/p>\n

These types of indicators are also useful if you need to write a lot of instructions that aren\u2019t actually that complicated. If you reassure people who are faced with a \u201cwall-of-text\u201d that the information is not as complicated as it may look, you can encourage them to actually engage with the text.<\/p>\n

Better knowledge sharing in your organization<\/h4>\n

Want more inspiration on sharing knowledge<\/a>? Download our\u00a0Knowledge Management e-book<\/a>\u00a0for tips and tricks on knowledge bases, and a way to calculate your time and cost savings.<\/p>\n","protected":false},"excerpt":{"rendered":"

So often, the problem with knowledge bases is that they are hard to understand. Either the knowledge articles do contain the knowledge and it\u2019s just not communicated that well, or the knowledge base is hard to coordinate. So what do you do? Learn how to write good knowledge base articles here. What is a good<\/p>\n","protected":false},"author":1,"featured_media":20626,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":"","inline_featured_image":false,"editor_notices":[],"footnotes":""},"class_list":["post-20596","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry"],"acf":{"blog_author":"","blog_hubspot_cta_link":"","toc_display":"full","blog_promotion_overwrite":false,"blog_promotion":false},"yoast_head":"\nWriting Better Knowledge Base Articles - Tips & Best Practices<\/title>\n<meta name=\"description\" content=\"Learn how to write effective knowledge base articles with tips on structure, clarity, and relevance. Improve your writing skills now with TOPdesk.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Writing better Knowledge Base Articles | Better support, happy customers | TOPdesk\" \/>\n<meta property=\"og:description\" content=\"Learn how to write effective knowledge base articles with tips on structure, clarity, and relevance. Improve your writing skills now with TOPdesk.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/\" \/>\n<meta property=\"og:site_name\" content=\"T1 TOPdesk - EN\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/TOPdesk\/\" \/>\n<meta property=\"article:published_time\" content=\"2024-01-18T10:36:44+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-05-20T11:28:15+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/Online-image-Flexible-Office-Space-5.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"800\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Timon\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Timon\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/\"},\"author\":{\"name\":\"Timon\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/995a8f0b06d438e37fd23df568798916\"},\"headline\":\"Writing better Knowledge Base Articles\",\"datePublished\":\"2024-01-18T10:36:44+00:00\",\"dateModified\":\"2025-05-20T11:28:15+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/\"},\"wordCount\":616,\"publisher\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/Online-image-Flexible-Office-Space-5.png\",\"articleSection\":[\"ITSM\",\"Knowledge Management\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/\",\"url\":\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/\",\"name\":\"Writing Better Knowledge Base Articles - Tips & Best Practices\",\"isPartOf\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/Online-image-Flexible-Office-Space-5.png\",\"datePublished\":\"2024-01-18T10:36:44+00:00\",\"dateModified\":\"2025-05-20T11:28:15+00:00\",\"description\":\"Learn how to write effective knowledge base articles with tips on structure, clarity, and relevance. Improve your writing skills now with TOPdesk.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#primaryimage\",\"url\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/Online-image-Flexible-Office-Space-5.png\",\"contentUrl\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/Online-image-Flexible-Office-Space-5.png\",\"width\":1200,\"height\":800},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.topdesk.com\/en\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Writing better Knowledge Base Articles\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#website\",\"url\":\"https:\/\/www.topdesk.com\/en\/\",\"name\":\"TOPdesk\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.topdesk.com\/en\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#organization\",\"name\":\"TOPdesk\",\"url\":\"https:\/\/www.topdesk.com\/en\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/TOPdesk_RGB_Logo.svg\",\"contentUrl\":\"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/TOPdesk_RGB_Logo.svg\",\"width\":1,\"height\":1,\"caption\":\"TOPdesk\"},\"image\":{\"@id\":\"https:\/\/www.topdesk.com\/en\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/TOPdesk\/\",\"https:\/\/www.instagram.com\/topdeskuk\/\",\"https:\/\/www.linkedin.com\/company\/topdesk\/\",\"https:\/\/www.youtube.com\/user\/topdesk\",\"https:\/\/en.wikipedia.org\/wiki\/TOPdesk\",\"https:\/\/www.gartner.com\/reviews\/market\/it-service-management-platforms\/vendor\/topdesk\",\"https:\/\/www.capterra.com\/p\/127562\/TOPdesk\/\",\"https:\/\/www.trustradius.com\/products\/topdesk\/reviews\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/995a8f0b06d438e37fd23df568798916\",\"name\":\"Timon\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/1fac7dde1292f6d6d9f0a1a1cb50176a90d95f13cc97c2dc977b11e0787668c8?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/1fac7dde1292f6d6d9f0a1a1cb50176a90d95f13cc97c2dc977b11e0787668c8?s=96&d=mm&r=g\",\"caption\":\"Timon\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Writing Better Knowledge Base Articles - Tips & Best Practices","description":"Learn how to write effective knowledge base articles with tips on structure, clarity, and relevance. Improve your writing skills now with TOPdesk.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/","og_locale":"en_US","og_type":"article","og_title":"Writing better Knowledge Base Articles | Better support, happy customers | TOPdesk","og_description":"Learn how to write effective knowledge base articles with tips on structure, clarity, and relevance. Improve your writing skills now with TOPdesk.","og_url":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/","og_site_name":"T1 TOPdesk - EN","article_publisher":"https:\/\/www.facebook.com\/TOPdesk\/","article_published_time":"2024-01-18T10:36:44+00:00","article_modified_time":"2025-05-20T11:28:15+00:00","og_image":[{"width":1200,"height":800,"url":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/Online-image-Flexible-Office-Space-5.png","type":"image\/png"}],"author":"Timon","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Timon","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#article","isPartOf":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/"},"author":{"name":"Timon","@id":"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/995a8f0b06d438e37fd23df568798916"},"headline":"Writing better Knowledge Base Articles","datePublished":"2024-01-18T10:36:44+00:00","dateModified":"2025-05-20T11:28:15+00:00","mainEntityOfPage":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/"},"wordCount":616,"publisher":{"@id":"https:\/\/www.topdesk.com\/en\/#organization"},"image":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#primaryimage"},"thumbnailUrl":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/Online-image-Flexible-Office-Space-5.png","articleSection":["ITSM","Knowledge Management"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/","url":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/","name":"Writing Better Knowledge Base Articles - Tips & Best Practices","isPartOf":{"@id":"https:\/\/www.topdesk.com\/en\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#primaryimage"},"image":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#primaryimage"},"thumbnailUrl":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/Online-image-Flexible-Office-Space-5.png","datePublished":"2024-01-18T10:36:44+00:00","dateModified":"2025-05-20T11:28:15+00:00","description":"Learn how to write effective knowledge base articles with tips on structure, clarity, and relevance. Improve your writing skills now with TOPdesk.","breadcrumb":{"@id":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#primaryimage","url":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/Online-image-Flexible-Office-Space-5.png","contentUrl":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/Online-image-Flexible-Office-Space-5.png","width":1200,"height":800},{"@type":"BreadcrumbList","@id":"https:\/\/www.topdesk.com\/en\/blog\/writing-better-knowledge-base-articles\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.topdesk.com\/en\/"},{"@type":"ListItem","position":2,"name":"Writing better Knowledge Base Articles"}]},{"@type":"WebSite","@id":"https:\/\/www.topdesk.com\/en\/#website","url":"https:\/\/www.topdesk.com\/en\/","name":"TOPdesk","description":"","publisher":{"@id":"https:\/\/www.topdesk.com\/en\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.topdesk.com\/en\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.topdesk.com\/en\/#organization","name":"TOPdesk","url":"https:\/\/www.topdesk.com\/en\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.topdesk.com\/en\/#\/schema\/logo\/image\/","url":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/TOPdesk_RGB_Logo.svg","contentUrl":"https:\/\/www.topdesk.com\/en\/wp-content\/media\/sites\/30\/TOPdesk_RGB_Logo.svg","width":1,"height":1,"caption":"TOPdesk"},"image":{"@id":"https:\/\/www.topdesk.com\/en\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/TOPdesk\/","https:\/\/www.instagram.com\/topdeskuk\/","https:\/\/www.linkedin.com\/company\/topdesk\/","https:\/\/www.youtube.com\/user\/topdesk","https:\/\/en.wikipedia.org\/wiki\/TOPdesk","https:\/\/www.gartner.com\/reviews\/market\/it-service-management-platforms\/vendor\/topdesk","https:\/\/www.capterra.com\/p\/127562\/TOPdesk\/","https:\/\/www.trustradius.com\/products\/topdesk\/reviews"]},{"@type":"Person","@id":"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/995a8f0b06d438e37fd23df568798916","name":"Timon","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.topdesk.com\/en\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/1fac7dde1292f6d6d9f0a1a1cb50176a90d95f13cc97c2dc977b11e0787668c8?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/1fac7dde1292f6d6d9f0a1a1cb50176a90d95f13cc97c2dc977b11e0787668c8?s=96&d=mm&r=g","caption":"Timon"}}]}},"_links":{"self":[{"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/posts\/20596","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/comments?post=20596"}],"version-history":[{"count":11,"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/posts\/20596\/revisions"}],"predecessor-version":[{"id":44745,"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/posts\/20596\/revisions\/44745"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/media\/20626"}],"wp:attachment":[{"href":"https:\/\/www.topdesk.com\/en\/wp-json\/wp\/v2\/media?parent=20596"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}