Creating an FAQ Item
- Go to Admin → Content → FAQ.
- Click Add FAQ Item.
- Fill in the fields.
- Click Save.
The new item is visible on /faq immediately if its Active toggle is enabled.
FAQ Item Fields
| Field | Required | Notes |
|---|---|---|
| Question | Yes | The heading text shown in the accordion |
| Answer | Yes | The expanded content; supports HTML and Markdown |
| Sort Order | Yes | Controls display position; lower = higher on page |
| Active | Yes | Toggle off to hide without deleting |
Writing Good Answers
Answers support HTML and Markdown, so you can include:
- Bold and italic text
- Bulleted and numbered lists
- Inline
codefor command examples - Links to Knowledge Base articles or external resources
Keep answers to 2–5 sentences for straightforward questions. If more detail is needed, write a KB article and end your FAQ answer with a link: "For step-by-step instructions, see How to Reset Your Password."
[!TIP] Write the question exactly as a client would ask it — first person, plain language. "How do I cancel my service?" is better than "Service Cancellation Process."
Reordering Items
FAQ items are ordered by the Sort Order field. To reorder:
- Edit the items whose positions you want to change.
- Update their Sort Order values.
- Save each item.
Use increments of 10 (10, 20, 30…) to make future insertions easy without renumbering all existing items.
Toggling an Item Active/Inactive
Set Active to off to hide an item from the portal FAQ page without deleting it. The item remains in the admin list and can be reactivated at any time. This is useful for seasonal or time-limited answers.
Editing an Item
Click the item's question text or the Edit action in the FAQ list. All fields are editable. Changes are reflected on the portal immediately after saving.
Deleting an Item
[!WARNING] FAQ item deletion is permanent. Before deleting, consider setting the item to Inactive instead, which hides it while preserving the content.
To delete:
- Click Delete in the actions column for the item.
- A confirmation modal will appear.
- Enter your admin password to confirm.
- Click Confirm Delete.
The item is permanently removed and the FAQ page re-renders without it.