API Blog Sign in

Managing Articles

Knowledge base articles are the content that powers your public help center at hc.airclou.com. Articles are organized into a hierarchy of brands, categories, sections, and individual articles.

Content hierarchy

Brand (your help center)
  └── Category (top-level grouping)
      └── Section (sub-grouping)
          └── Article (individual help content)

Article fields

FieldDescription
TitleArticle title (up to 200 characters)
SlugURL-friendly identifier, auto-generated or editable
BodyRich content authored in the TipTap editor
Statusdraft, published, or archived
VisibilityWho can see the article (see below)
LocaleLanguage of the article (default: en)
Content typehow-to, faq, troubleshooting, reference, or policy
TagsIntent, product, region, and keyword tags for search optimization

Visibility levels

LevelWho can see it
PublicAnyone visiting the help center
Signed inOnly authenticated users
SegmentOnly users in specific customer segments
InternalOnly visible in the admin UI, never public

Creating an article

  1. Navigate to Knowledge Base in the sidebar
  2. Select a brand, then a category and section
  3. Click New Article
  4. Write your content in the TipTap rich text editor
  5. Set visibility, locale, and metadata tags
  6. Click Publish when ready

Articles in draft status are not visible in the public help center.

Editing slugs

Article, category, and section slugs can be edited after creation. When you change a slug, the old slug is saved and automatically redirects (301) to the new URL. This preserves any existing links.

Versioning

Each time you publish an article, a version snapshot is created. You can view version history and compare changes between versions from the article editor.

Search and discovery

Articles are searchable in the public help center using hybrid search (keyword + semantic). The search indexes article titles and plain-text content. Add keywords to the metadata to improve discoverability.