A self-service document scoped to one support question, written once to deflect repeat contacts from the same issue.
A knowledge base article is a single self-service support document that answers one question or solves one problem, so a user can resolve an issue without contacting a human. It is the unit of the help centre. A single article is written once and read by many, deflecting a support contact each time it answers.
The methodology behind the modern support knowledge base was formalised by the Consortium for Service Innovation, founded in Seattle in 1992, which developed what is now called Knowledge-Centered Service (originally SolutionSolutionDiscoveryA proposed approach to address an opportunityView reference →-Centered Support, later Knowledge-Centered Support). Its premise is to capture, structure, and reuse support knowledge by integrating the knowledge base directly into the support workflow, so that resolving a ticket and writing the article that prevents the next one become the same act. KCS reframed the article as a by-product of solving real problems, written in the customer's words, rather than documentation drafted in advance by a technical writer who never took the call.
The method evolved with the channel. KCS v6, released in April 2016, renamed the practice from Knowledge-Centered Support to Knowledge-Centered Service as adoption spread beyond technical support into the wider enterprise. Meanwhile the business case crystallised around deflection: every search that ends in a resolved problem is a ticket that never reached an agent. Vendors such as Zendesk built help centres that surface relevant articles inside chat, email forms, and in-app widgets to catch the question before it becomes a contact.
The live frontier is AI. Assistants now answer directly from approved articles, summarise them, and flag content gaps where searches fail. This raises the stakes on freshness: an AI that confidently relays a stale article amplifies the maintenance burden that knowledge bases have always carried, and it turns "is this article still true?" from a periodic chore into a continuous obligation.
A SaaS company sees 400 monthly tickets about a single billing question: how to switch from monthly to annual. A support lead writes one knowledge base article, in plain language, with screenshots and the exact menu path, then wires it to appear when a user types "billing" into the help widget and at the top of the contact form.
The next month, ticket volume on that question drops to 90. The article was read 2,100 times; most readers found their answer and left. The deflection is real, and so is the new duty. When the billing UI is redesigned two quarters later, the screenshots go wrong, searches start failing, and the deflection rate decays until someone updates the article. The article kept paying out only as long as it stayed true.
Krug's work on web usability argues that users under taskTaskProduct SpecificationA unit of work within a story or epicView reference → pressure scan rather than read, and that any friction in finding or parsing an answer triggers abandonment rather than effort. By that reading, an article's deflection value depends not only on its accuracy but on whether a user arriving mid-task can locate the relevant step within seconds — a plain headline, numbered steps, and a single clear outcomeOutcomeStrategyA desired business or user outcomeView reference → are not stylistic choices but functional requirements for the self-service premise to hold.
In the Unified Product Graph, a knowledge base article sits where content meets support. The product connects to its self-service documentation through Productdocuments inKnowledge Base Articlehierarchy, and a calendar can schedule that documentation through product_documents_in_knowledge_base_articleContent CalendarschedulesKnowledge Base Articlehierarchy, which treats help content as editorial work with cadence and ownership rather than an afterthought. The article binds to what it explains through content_calendar_schedules_knowledge_base_articleKnowledge Base ArticledocumentsFeaturecross-domain, so a feature with no documenting article is a queryable gap, and a tutorial can build on it through knowledge_base_article_documents_featureTutorialreferencesKnowledge Base Articlecross-domain. That structure attacks the maintenance burden head-on: when a feature changes, the edge to its articles shows exactly which documents now riskRiskComplianceA risk to the product or businessView reference → going stale.tutorial_references_knowledge_base_article
Type-specific fields on BaseNode
audienceenumWho this article is intended for
urlstringURL of the published article
idstringrequiredUnique identifier (UUID)
typeNodeTyperequiredDiscriminator for the entity type
titlestringrequiredDisplay name
descriptionstringOptional detailed description
statusstringLifecycle status
tagsstring[]Freeform tags for filtering
4 phases, initial: draft · template: PUBLISHING
4 edge types connected to this entity.
product_documents_in_knowledge_base_articlecontent_calendar_schedules_knowledge_base_article