Skip to main content

What the Help Center is

The Help Center is Halo’s customer-facing knowledge site. You write articles in the dashboard, organize them into collections, theme the public site, and publish at a custom domain. Every published article also feeds your AI’s knowledge base — so the same article serves both self-serve customers and the AI agent helping them. You can have one help center per workspace in Halo. Visit it at help.yourcompany.com (or the default /hc/{slug} URL) once it’s published. Find it in the dashboard at Help Center in the sidebar (/dashboard/help-center).

What it gives you

FeatureWhat it does
ArticlesBlock-style rich text editor with AI-assisted writing
CollectionsGroup articles into navigable categories
DesignTheme colors, fonts, hero, layout, footer, custom CSS
Custom domainPublish at help.yourcompany.com with DNS verification
Multi-languageDefault language + supported languages with /{lang} URL prefix
SEO defaultsTitle templates, OG image generation, meta descriptions
AnalyticsPageviews, search queries, zero-result searches, per-article views
MigrationImport from URL crawl or Intercom API
Embedded chat widgetSame Halo widget you use in your app, embedded on the help center
AI KnowledgeArticles auto-feed your AI’s knowledge base (toggleable per article)
VisibilityPublic, authenticated (SSO/JWT), or company-specific articles

Setup flow

1

Create your help center

Go to Help Center in the sidebar. The first time, you’ll see a setup card. Click Create your Help Center and Halo provisions the data and starter design.
2

Add your first articles

Either write fresh articles in the editor or use Migrate to import from your existing help center (URL crawl or Intercom).
3

Organize with collections

Create collections (Getting Started, Integrations, Billing, etc.) and assign articles to them.
4

Customize the design

Theme colors, hero section, fonts, layout, and footer to match your brand.
5

Publish

Set the help center to Live. By default it’s available at /hc/{your-slug}.
6

Add a custom domain (optional)

Add help.yourcompany.com, configure DNS, verify, and your help center serves at that domain.

Sections in the dashboard

The Help Center workspace has six tabs:
TabWhat you do there
ArticlesWrite, edit, publish, schedule, and bulk-manage articles
CollectionsCreate and reorder collections
DesignLive preview of the public site as you change theme settings
AnalyticsTraffic, top searches, zero-result queries, per-article views
MigrateImport from URL crawl or Intercom API
SettingsLanguages, SEO defaults, indexing, custom scripts, auth, notifications

How articles connect to the AI

Every article you publish has an include_in_training flag (default: on). When on, the article is:
  • Chunked, embedded, and added to your knowledge base under source_type: help_center_article
  • Automatically re-synced when you edit the article
  • Removed from knowledge if you turn include_in_training off
This means the same article can:
  • Power self-service search on your help center
  • Feed the AI agent in your app’s widget
  • Show up as a citation in AI responses
  • Be referenced by the help center’s embedded chat widget
A single source of truth for both your customers and your AI.

Public vs authenticated articles

Articles have a visibility field:
VisibilityWho can see it
PublicAnyone with the URL
AuthenticatedRequires your help center auth (SSO/JWT)
Company-specificVisible only to users from specific allowed companies
Non-public articles require setting up auth_provider, jwt_secret, and login_url in Settings. Without those, restricted articles show a “Sign in required” empty state. For semantic search on the public site, only public published articles are searchable to anonymous visitors.

Where to go next

Articles

The block editor, AI assistance, SEO, scheduling, and versioning.

Collections

Organize articles into navigable categories.

Design

Theme colors, fonts, layout, footer, and custom CSS.

Domains & Publishing

Custom domains, indexing, and going live.

Migrating

Import from URL crawl or Intercom.

Analytics

Pageviews, top searches, and zero-result queries.