Authoring help articles

Updated April 21, 2026

Help articles live under /help/manage/ for superusers. Organization admins can also override global articles for their own org — see Customizing help for your organization.

Where to author

Superuser: Help Center → Manage Articles (visible only to superusers).

Organization admin: Admin → Manage Org Help.

Markdown supported

Articles are written in Markdown and rendered on view. Supported:

  • Headings, lists, links, code blocks, tables, task lists, strikethrough
  • Inline images — upload under the article's Images section and paste the generated ![alt](url) snippet into the body.
  • Image upload destination is the same storage as the rest of CrewCall (S3 in production, MinIO in dev).

Raw HTML in the source is escaped for safety — stick to Markdown.

Slugs

Slugs are stable identifiers used by in-app help links ({% help_icon %} tags). Changing a slug breaks inbound links. When in doubt, leave the slug alone and edit the title/body.

Categories and ordering

Each article belongs to a category (or none). Categories have a position field that controls the sidebar order.

Publishing

Unpublished articles are invisible to regular users. Use this to draft in place without taking the article offline. Publish when ready.