FAQ

The FAQ module lets you publish and maintain a library of questions and answers on your site. Items support rich-text answers, categories, tags, pinned and featured flags, and SEO metadata. Changes go through the same Draft → Review → Published lifecycle as your other content.

FAQ List

The main FAQ view shows all items in your workspace. Switch between card, list, and table layouts using the view toggle in the toolbar.

Key fields shown in the list:

• Question: The customer-facing question text.
• Status: Draft, Review, Published, or Archived.
• Category: The category this item belongs to (if assigned).
• Views: How many times this item has been viewed on the public site.
• Helpful: Upvote tally from the public site's helpfulness prompt.
• Last updated: When the item was last saved.

Filtering and search:

• Filter by status, category, or site using the filter panel.
• Use the search input to find items by question text or excerpt.
• Sort by last updated, creation date, display weight, or alphabetically.

Hover over any card or row to reveal inline Edit, Duplicate, and Delete buttons.

Creating FAQ Items

Click New FAQ item in the header. Provide a question, select a site, and optionally assign a category. The slug is auto-generated from the question text but can be edited manually.

After creation you are taken to the item editor.

Item Editor

The editor has two tabs: Content and Settings.

Content tab

• Question — the heading shown to visitors.
• Answer — a full rich-text editor (bold, italic, lists, links, images, tables, code blocks, and more). Use the source editor button to view or paste raw HTML.
• Excerpt — a short plain-text summary displayed in search results and on the FAQ index page. If omitted, the first lines of the answer are used.
• Tags — freeform labels for grouping and filtering. Type a tag and press Enter to add it.
• Related items — enter the IDs of other FAQ items to surface related questions below the answer.

Settings tab

• Status — Draft, Review, Published, or Archived. Editors and Admins can publish directly. Authors submit for review.
• Published at — when the item was (or will be) made public.
• Slug — the URL segment for this item: example.com/faq/:slug.
• Category — assign to a category for grouped display on the public site.
• Weight — integer used to order items within their category. Lower numbers appear first. Items with the same weight are sorted alphabetically.
• Pinned — pinned items appear at the top of the FAQ index, above all other items.
• Featured — marks an item as highlighted. Themes may display featured items prominently.
• SEO title / SEO description — override the page title and meta description for search engines. If blank, the question and excerpt are used.

Save your changes with the Save button in the topbar or by pressing Enter in any text input. The status badge in the topbar reflects the current published state.

Categories

Categories group related FAQ items into sections on the public site. Manage them from the Categories link in the FAQ header.

Each category has a name, slug, and optional description. Drag rows to reorder categories — the order determines the sequence of sections on the public FAQ page. Categories can be edited and deleted; deleting a category does not delete its items, it just removes their category assignment.

Bulk Actions

Click Select in the header to enter selection mode. Tick the checkboxes on items you want to act on. Once a selection is made, the bulk action bar appears at the bottom:

• Publish — publish all selected drafts.
• Archive — archive all selected items.
• Delete — permanently delete selected items. This cannot be undone.
• Move to category — assign all selected items to a different category.
• Add tag — add a tag to all selected items at once.

Import and Export

Use the three-dot menu in the header to import or export FAQ items.

Export: Download all items as JSON or CSV. The export includes all fields — question, answer, excerpt, status, category, tags, weight, pinned, featured, slug, SEO fields, and timestamps.

Import: Upload a JSON or CSV file. Items are matched by slug — existing slugs are updated, new slugs are created. Category and site assignments are resolved by slug. Import errors are listed after processing so you can correct and re-upload.

Public FAQ Page

When items are Published, they appear on your site's public FAQ index at /faq. The layout depends on your theme.

• Items are grouped by category. Items with no category appear in an uncategorised group.
• Within each category, items are sorted by weight then alphabetically.
• Pinned items appear above all categories.
• Visitors can mark an answer as helpful or not helpful. Vote counts are shown in the FAQ list.
• Each item has its own permalink at /faq/:slug.

Tips:

• Set a weight on items when order within a category matters (e.g., put "How do I sign up?" before "How do I cancel?").
• Write excerpts for every item — they appear in search results and on the FAQ index under each question heading.
• Use the Category order on the Categories page to control the sequence of sections visitors see.
• Review helpful/not-helpful ratios periodically. Low helpful scores often indicate answers that need clarification.