Knowledge Base Style Guide Template

Example — Fictional content for illustration purposes

IT knowledge base style guide — v2.0


Scope
IT Support Knowledge Base
Version
v2.0 — Updated 01/02/2026
Owner
MKMarie Kowalski
Next Review
01/08/2026

🎯 Tone of voice

Write as a knowledgeable colleague — clear, direct, and helpful. Use second person ("you") when addressing the reader. Avoid jargon unless the audience is exclusively technical. Keep sentences under 25 words. Use active voice: "Click Settings" not "Settings should be clicked."

📝 Naming conventions

ElementConventionExample
Article titleSentence case — action + subjectFix VPN timeout errors on macOS
TagsLowercase, singular, no abbreviationsvpn, macos, network
CategoriesMax 2 levels — broad then specificNetwork > VPN

📐 Article structure

  1. Summary — 1–2 sentences describing the problem and solution (appears in search results).
  2. Symptoms — what the user sees or experiences.
  3. Cause — why the issue occurs (if known).
  4. Resolution — numbered steps to fix the problem.
  5. Related articles — links to connected topics.

✅ Quality checklist

  • Title follows naming convention (action + subject, sentence case)
  • Summary is under 30 words
  • Steps are numbered and start with a verb
  • Screenshots are annotated with red boxes on key elements
  • All links are tested and point to current articles
  • Tags use approved vocabulary (see tag library)
This is an example — create yours in Elium

Give knowledge managers and content owners a shared set of writing, formatting, and naming standards for their knowledge base. This template defines tone of voice, structure, naming conventions, and quality criteria — so every contributor produces articles that are consistent, searchable, and useful.

Try now in Elium

What is a knowledge base style guide?

A knowledge base style guide is a reference document that defines the writing standards, formatting rules, and naming conventions for all content in a knowledge base. It ensures that every article — regardless of author — follows the same structure, tone, and quality criteria so readers get a consistent experience.

Without a style guide, knowledge bases become inconsistent within months. One author writes formal paragraphs, another uses bullet lists. Titles follow different conventions. Terminology varies between teams. The result is a knowledge base that looks unprofessional and is hard to search because the same concept has three different names. A style guide prevents this drift by giving every contributor a clear, shared standard to follow.

Who should use this template?

This template is for teams responsible for knowledge base quality and governance:

  • Knowledge Managers — define and enforce writing standards across the organisation
  • Content Owners — follow consistent formatting and structure when creating or updating articles
  • Community Managers — coach contributors on quality standards and provide feedback based on documented criteria
  • IT and Operations Teams — adopt a shared vocabulary when documenting procedures and technical guides

What’s included in this template?

The template has two parts: structured metadata fields and the style guide body.

Metadata fields classify the guide:

  • Style guide name and version
  • Knowledge base scope (company-wide, department, or space-specific)
  • Guide owner — the person accountable for maintaining the standards
  • Last updated date and next review date

Style guide body covers every standard:

  • Tone of voice — writing style, formality level, and audience expectations
  • Article structure — required sections, heading hierarchy, and content length guidelines
  • Naming conventions — rules for article titles, tags, and categories to ensure consistency and searchability
  • Formatting rules — use of bullet lists, tables, images, links, and callouts
  • Quality criteria — checklist for review: accuracy, completeness, clarity, and currency
  • Examples — good and bad examples illustrating each standard

How to create and customise this template in Elium

  1. Open the Template Builder — Go to your profile menu and select the Template Builder tab, or click “+ Create” and choose “Create a new template”.
  2. Set the scope — Choose an icon, enable the template, and decide whether it applies platform-wide or to specific spaces.
  3. Add structured fields — Click “Field” to add metadata: text fields for style guide name and version, a tag field for scope (pre-populate with “Company-wide”, “Department”, “Space-specific”), a user field for guide owner, and date fields for last updated and next review. Mark guide name and owner as mandatory.
  4. Build the style guide structure — Use the “+” button to add content blocks: text blocks for tone of voice, article structure, naming conventions, formatting rules, and quality criteria. Add a section with good and bad examples to illustrate each standard clearly.
  5. Preview and save — Review the template layout, then save. Knowledge managers can now reference it when onboarding new contributors, and you can apply it to existing content in bulk.

How AI helps you create and use this template

Capture faster. Describe your organisation’s writing preferences — formal or conversational, technical or accessible — and Elium’s AI generates a first draft of your style guide with tone of voice guidelines, formatting rules, and naming conventions that you refine.

Retrieve smarter. A contributor asks Elium’s AI: “How should I title an article about VPN troubleshooting for remote users?” The AI returns the naming convention from your style guide — format, capitalisation, and keyword placement — so every article follows the same pattern.

Why teams use Elium for knowledge governance

A knowledge base with 4,000 articles and hundreds of contributors needs guardrails. Without documented standards, quality degrades as the knowledge base grows — articles become harder to find and less trustworthy. Elium makes governance practical: style guides live alongside the content they govern, contributors reference standards from within their writing workflow, and search ensures the guide itself is always one question away.

VINCI Energies — 97,000 employees across 61 countries — manages over 4,000 articles in Elium with 500+ daily users. At that scale, consistent writing standards are essential. A shared style guide ensures that articles contributed by engineers in France, technicians in Germany, and project managers in Brazil follow the same structure and quality criteria.

Frequently asked questions

A knowledge base style guide defines writing standards, formatting rules, and naming conventions for all knowledge base content. Without one, articles become inconsistent as contributors follow different approaches. Inconsistency undermines trust and searchability — when the same concept has multiple names, users cannot find what they need.
A complete style guide includes tone of voice guidelines, article structure requirements, heading hierarchy, naming conventions for titles and tags, formatting rules for lists and tables, quality criteria for review, and good and bad examples illustrating each standard. A version number and review date ensure the guide stays current.
A style guide improves searchability because consistent naming means users find articles on the first query. It accelerates contribution because writers follow a clear standard rather than guessing. It maintains quality at scale because reviewers have documented criteria. It reduces governance overhead because standards are self-service rather than relying on a single gatekeeper.
Start with the most impactful standards — naming conventions and article structure. Keep rules specific and actionable: “Use sentence case for titles” is better than “Be consistent.” Include examples for every rule. Limit the guide to one page if possible — contributors will not read a 20-page document. Review and update quarterly.
A style guide defines how to write — tone, format, naming, and structure. A content governance policy defines how to manage — who can publish, review cycles, archival rules, and ownership responsibilities. The style guide ensures quality at the article level; the governance policy ensures quality at the knowledge base level.

Related reading: Read more on our blog