Skip to main content
The Help Center in Chatwoot allows you to create a self-service knowledge base portal where customers can find answers to their questions without contacting support. Build a comprehensive documentation site with articles, categories, and full customization options.

​
What is a Help Center?

A Help Center (also known as a knowledge base or portal) is a public-facing website that contains:
  • Articles - Documentation pages with detailed information
  • Categories - Organizational structure to group related articles
  • Search functionality - Full-text search across all content
  • Multi-locale support - Content in multiple languages
  • Custom branding - Match your brand colors and style

​
Key Features

Multi-language Support

Create content in multiple locales with per-language article versions and category translations.

Rich Content Editor

Write articles with full Markdown/HTML support, including headings, lists, images, and code blocks.

Article Search

Built-in full-text search across article titles, descriptions, and content with real-time suggestions.

View Analytics

Track article views to understand which content is most popular and helpful.

Article Status

Control article visibility with draft, published, and archived states.

Custom Domain

Host your Help Center on your own domain with SSL support.

​
Article Features

​
Content Management

  • Rich text content - Full HTML/Markdown support for article body
  • Metadata - Title, description (meta tag), and custom slug
  • Positioning - Manual ordering within categories
  • Authorship - Track article authors and creation dates
  • Associated articles - Link related articles across locales

​
Publishing Workflow

1

Draft

Create and edit articles in draft mode without making them public
2

Published

Make articles visible to customers on the public portal
3

Archived

Hide outdated articles while preserving content for reference

​
Article Schema

Each article contains: 
# Core fields
title           # Article heading
content         # Full article body (HTML/Markdown)
description     # Short summary for meta tags
slug            # URL-friendly identifier
locale          # Language code (e.g., 'en', 'es')
status          # draft (0), published (1), or archived (2)
position        # Sort order within category
views           # View count tracking

# Relationships
portal_id       # Parent portal
category_id     # Optional category assignment
author_id       # User who created the article
associated_article_id  # Link to parent article for translations

​
Portal URL Structure

Help Centers are accessible at: 
https://your-domain.com/hc/{portal-slug}/{locale}/
Article URLs: 
https://your-domain.com/hc/{portal-slug}/{locale}/articles/{article-slug}
Category URLs: 
https://your-domain.com/hc/{portal-slug}/{locale}/categories/{category-slug}

​
Theme Support

The Help Center supports automatic theme switching:
  • Light mode - Default bright theme
  • Dark mode - Dark theme for reduced eye strain
  • System - Follows user’s OS preference
Theme preferences are persisted in localStorage and sync with system changes.

​
Search Functionality

The portal includes powerful search features:
PostgreSQL-powered text search with ranking:
  • Title matches weighted highest (A)
  • Description matches weighted medium (B)
  • Content matches weighted lower (C)
  • Results normalized by document length
Filter results by:
  • Locale/language
  • Category
  • Author
  • Status (published/draft/archived)
Vue-powered search component with instant results as you type

​
Getting Started

Create Articles

Learn how to write and publish articles

Organize Categories

Structure your content with categories

Customize Portal

Brand your Help Center with custom colors and settings

​
Best Practices

Start with categories - Plan your information architecture before creating articles. Well-organized categories make it easier for customers to find answers.
Use descriptive titles - Article titles appear in search results and should clearly indicate the content.
Add table of contents - For long articles, the automatic table of contents helps users navigate to specific sections.
Locale consistency - Articles inherit their locale from their category. Make sure categories exist for all supported locales.

Build docs developers (and LLMs) love

Get started for freeTalk to us