Structuring your knowledge base
A well-structured knowledge base makes it easy for your team to find what they need, when they need it β reducing confusion, repeat questions, and support tickets. BlueDocs gives you full control over categories, folders, tags, and document types so you can build an internal help centre that scales with your organization.
This article shares best practices to structure your knowledge base effectively.
Before creating documents, think about:
Who will be using the knowledge base?
What questions do they need answered regularly?
Which teams or roles have unique needs?
This helps ensure the structure is logical and intuitive.
Categories should represent high-level topics or functional areas. For example:
Getting Started
HR & People
IT & Security
Training & Onboarding
Tools & Software
Policies & Compliance
π Tip: Avoid creating too many categories. Aim for 6β10 well-defined areas.
Inside each category, use folders to group related documents more granularly.
Example:
Use folder emojis or color codes in BlueDocs to visually differentiate sections.
Tags help users filter across categories and folders.
β Useful tags might include:
Remote
Finance
Sales
Urgent
Monthly Review
π Tip: Keep tag names consistent β use singular/plural uniformly (e.g., Policy not Policies).
In BlueDocs, you can define custom document types like:
SOP
How-To Guide
Policy
FAQ
Training Module
This makes it easier to scan and filter content. Use icons to visually reinforce document types.
Each document title should:
Clearly describe the purpose
Avoid vague names like βNotesβ or βProcess 1β
Include key phrases users might search for
β Example:
Good: How to Request Annual Leave in BambooHR
Bad: Leave Request Guide
Cross-linking helps users discover related content and builds a connected knowledge base.
β Example:
βBefore submitting a reimbursement, review our Expense Policy.β
Knowledge bases should evolve. Use these BlueDocs features to keep content current:
Version history and last updated dates
Assign owners for each document
Review reminders and auto-expiring approvals
Not all users need access to everything. Use BlueDocsβ role-based visibility to:
Hide admin-only or HR-private docs
Deliver role-specific onboarding pages
Segment SOPs by department
Use analytics to:
See which documents are most viewed
Identify underused or hard-to-find content
Spot gaps where new articles are needed
Start simple and scale as needed. A good structure today is better than a perfect one tomorrow. You can always refactor content as your team grows and learns what works best.
Need help setting up your categories or importing existing docs? Reach out to support or book a quick setup call with our team.
This article shares best practices to structure your knowledge base effectively.
π― Start with Your Audience in Mind
Before creating documents, think about:
Who will be using the knowledge base?
What questions do they need answered regularly?
Which teams or roles have unique needs?
This helps ensure the structure is logical and intuitive.
π Use Categories for Major Themes
Categories should represent high-level topics or functional areas. For example:
Getting Started
HR & People
IT & Security
Training & Onboarding
Tools & Software
Policies & Compliance
π Tip: Avoid creating too many categories. Aim for 6β10 well-defined areas.
π Use Folders for Specific Subtopics
Inside each category, use folders to group related documents more granularly.
Example:
Category: Training & Onboarding
βββ Folder: New Hire Onboarding
βββ Folder: Manager Training
βββ Folder: Compliance Modules
Use folder emojis or color codes in BlueDocs to visually differentiate sections.
π·οΈ Use Tags for Cross-Cutting Themes
Tags help users filter across categories and folders.
β Useful tags might include:
Remote
Finance
Sales
Urgent
Monthly Review
π Tip: Keep tag names consistent β use singular/plural uniformly (e.g., Policy not Policies).
π Create Consistent Document Types
In BlueDocs, you can define custom document types like:
SOP
How-To Guide
Policy
FAQ
Training Module
This makes it easier to scan and filter content. Use icons to visually reinforce document types.
π Use Descriptive Titles & Search Keywords
Each document title should:
Clearly describe the purpose
Avoid vague names like βNotesβ or βProcess 1β
Include key phrases users might search for
β Example:
Good: How to Request Annual Leave in BambooHR
Bad: Leave Request Guide
π Link Documents Where Relevant
Cross-linking helps users discover related content and builds a connected knowledge base.
β Example:
βBefore submitting a reimbursement, review our Expense Policy.β
π Keep It Living β Not Static
Knowledge bases should evolve. Use these BlueDocs features to keep content current:
Version history and last updated dates
Assign owners for each document
Review reminders and auto-expiring approvals
π₯ Assign Visibility Based on Roles
Not all users need access to everything. Use BlueDocsβ role-based visibility to:
Hide admin-only or HR-private docs
Deliver role-specific onboarding pages
Segment SOPs by department
π Track Usage and Improve Structure
Use analytics to:
See which documents are most viewed
Identify underused or hard-to-find content
Spot gaps where new articles are needed
π§ Example Structure
π Knowledge Base
βββ π Getting Started
β βββ Platform Overview
β βββ Setting Up Your Account
βββ π Policies & Compliance
β βββ Leave Policies
β βββ IT Security Guidelines
βββ π₯ HR & People
β βββ Hiring Process
β βββ New Hire Docs
βββ π§βπ« Training & Onboarding
β βββ Department Paths
β βββ Quiz Modules
βββ π¬ Support & Troubleshooting
β βββ Common Issues
β βββ How to Contact Support
π Final Tip
Start simple and scale as needed. A good structure today is better than a perfect one tomorrow. You can always refactor content as your team grows and learns what works best.
Need help setting up your categories or importing existing docs? Reach out to support or book a quick setup call with our team.
Updated on: 26/05/2025
Thank you!