Skip to content

Organize with categories

Users shouldn't have to read every article to find the one they need. Categories let you group related articles so visitors can browse by topic from your help center homepage.

The help center is an experimental feature. Enable the helpCenter flag in Admin > Settings > Experimental before using any help center features.

How categories work

Categories are top-level groupings displayed as a grid on your help center homepage. Each category has:

  • Name — Required. Shown as the card title.
  • Description — Optional. Shown below the name on the homepage grid.
  • Emoji icon — Picked from ~50 options. Helps users scan at a glance.
  • Visibility toggle — Hidden categories don't appear on the public homepage.
  • Position — Controls the order cards appear in the grid.

Create a category

  1. Go to Admin > Help Center
  2. Click "+" in the sidebar
  3. Fill in the name, optional description, and pick an emoji
  4. Toggle Public on if you want it visible right away

Start with 3-5 categories. Common starting points: Getting Started, Features, Troubleshooting, FAQ. You can split or merge later as your content grows.

Reorder categories

Drag any category in the sidebar using its grip handle. The order you set here is the order visitors see on the homepage grid.

Edit and delete categories

Hover over a category row to reveal the edit and delete icons.

Deleting a category is permanent. You can't delete a category that still has articles — move or delete its articles first.

Category ideas by product type

Not sure how to organize? Here are common patterns:

SaaS products:

  • Getting Started, Features, Billing, API, Troubleshooting

Developer tools:

  • Installation, Configuration, API Reference, Migration, FAQ

Pick the structure that matches how your users think about your product, not how your team built it.

Next steps