# Manual Toggles vs Modern FAQ for Confluence — 3 Methods Compared

May 23, 2026 ·

<!-- -->

9 min read

[NGPilot](https://ngpilot.com)

<!-- -->

FAQ pages are one of the most visited sections of any documentation site. In Confluence, they serve a specific purpose: giving your team or customers quick answers to the questions they ask most often, without making them read through pages of documentation. A well-structured FAQ page reduces repetitive questions in Slack channels, shortens onboarding time for new team members, and deflects support tickets before they are created.

But Confluence does not have a built-in FAQ feature. Teams typically resort to manual workarounds — tables, toggle macros, or expand sections — that look cluttered and are hard to maintain. This guide shows you three methods to create professional FAQ pages in Confluence, from a quick manual setup to a fully featured FAQ macro.

## Method 1: Manual FAQ with Confluence Toggles (Quick but Limited)[​](#method-1-manual-faq-with-confluence-toggles-quick-but-limited "Direct link to Method 1: Manual FAQ with Confluence Toggles (Quick but Limited)")

If you need a basic FAQ section on a single page and do not want to install anything, you can use Confluence's built-in toggle macro. Each question becomes a toggle heading, and the answer appears when a reader clicks to expand it.

### How to set it up[​](#how-to-set-it-up "Direct link to How to set it up")

1. Open your Confluence page in edit mode
2. Type `/toggle` and select **Toggle heading**
3. Type the question as the heading text
4. Add the answer inside the toggle body
5. Repeat for each FAQ item

### What it looks like[​](#what-it-looks-like "Direct link to What it looks like")

Your page will show a series of collapsible headings. Readers click to expand each answer. This works for short FAQ sections with fewer than 10 questions.

### Limitations of the manual approach[​](#limitations-of-the-manual-approach "Direct link to Limitations of the manual approach")

* **No reordering.** If you want to move a question, you have to cut and paste the entire toggle block. With 20+ questions, this becomes painful.
* **Inconsistent styling.** Every toggle looks the same. You cannot distinguish between categories or highlight important answers.
* **No search-friendly formatting.** Toggle content is collapsed by default and does not show up well in Confluence search results.
* **Hard to maintain.** Adding, editing, or reorganizing questions means editing the raw page content. There is no dedicated FAQ management interface.

The manual approach works for a quick 5-question FAQ on a project page. For anything your team will maintain long-term, a dedicated FAQ macro is a better investment.

## Method 2: Modern FAQ for Confluence (Recommended)[​](#method-2-modern-faq-for-confluence-recommended "Direct link to Method 2: Modern FAQ for Confluence (Recommended)")

[Modern FAQ for Confluence](/docs/Modern-FAQ-for-Confluence/usage.md) is a dedicated FAQ macro that gives you drag-and-drop question management, two display themes, and a WYSIWYG editor for answers. It is designed specifically for teams that maintain FAQ pages as part of their documentation.

### Step-by-step: Create an FAQ section[​](#step-by-step-create-an-faq-section "Direct link to Step-by-step: Create an FAQ section")

**Step 1 — Install Modern FAQ for Confluence**

Go to the [Atlassian Marketplace](https://marketplace.atlassian.com/) and search for **Modern FAQ for Confluence**. Click **Get App** and follow the installation prompts. The app supports Confluence Cloud and Confluence Data Center.

**Step 2 — Insert the FAQ macro**

Open any Confluence page in edit mode. Type `/faq` and select **Modern FAQ for Confluence** from the macro dropdown. The FAQ editor appears on the page.

**Step 3 — Add your questions and answers**

Click **Add Question** to create your first FAQ item. Each item has two fields:

* **Question** — the text that readers see in the FAQ list
* **Answer** — a rich text editor where you can add formatted text, links, images, code blocks, and even other Confluence macros

Add as many questions as you need. The editor shows a live preview of how the FAQ section will look when published.

**Step 4 — Reorder with drag and drop**

Click and drag any question to rearrange the order. This is particularly useful when you want to:

* Move the most frequently asked questions to the top
* Group questions by topic or category
* Pin important announcements at the beginning of the list

No cut-and-paste needed. Drag, drop, and the order updates instantly.

**Step 5 — Choose a display theme**

Modern FAQ offers two display themes:

* **Centered** — questions are centered on the page with a clean, modern look. Best for product pages, landing pages, and customer-facing documentation.
* **Accordion** — questions are listed with expand/collapse functionality. Best for technical documentation, internal wikis, and pages with many FAQ items.

Select the theme in the macro settings. You can change it at any time without re-entering your content.

**Step 6 — Save and publish**

Click **Save** on the macro, then **Publish** the Confluence page. Your FAQ section is now live. Team members can view it immediately, and editors can click the macro to modify questions.

### FAQ page example[​](#faq-page-example "Direct link to FAQ page example")

Here is a real-world example of how a product team structures their FAQ page in Confluence using Modern FAQ:

**Product FAQ — API Integration**

| # | Question                                      | Answer Preview                                                 |
| - | --------------------------------------------- | -------------------------------------------------------------- |
| 1 | What authentication methods do you support?   | We support OAuth 2.0 and API key authentication...             |
| 2 | What is the rate limit for API requests?      | 1,000 requests per minute per API key...                       |
| 3 | Do you have a sandbox environment?            | Yes, use sandbox.api.example.com with your test credentials... |
| 4 | How do I handle pagination in list endpoints? | Use the `cursor` parameter returned in each response...        |
| 5 | What response formats are available?          | JSON is the default. XML is available on select endpoints...   |

With Modern FAQ, this content is managed through a dedicated editor — not as raw page elements. Adding a new question takes two clicks. Reordering takes a drag-and-drop. No risk of accidentally breaking the page layout.

### Why teams choose Modern FAQ over manual toggles[​](#why-teams-choose-modern-faq-over-manual-toggles "Direct link to Why teams choose Modern FAQ over manual toggles")

| Feature            | Manual Toggles                  | Modern FAQ                     |
| ------------------ | ------------------------------- | ------------------------------ |
| Add a question     | Type `/toggle`, format manually | Click **Add Question**         |
| Reorder questions  | Cut and paste blocks            | Drag and drop                  |
| Rich text answers  | Yes (manual formatting)         | Yes (WYSIWYG editor)           |
| Display themes     | None — all look the same        | Centered and Accordion         |
| Consistent styling | No — each toggle is independent | Yes — macro controls all items |
| Edit interface     | Inline on the page              | Dedicated FAQ editor           |
| Maintenance effort | High for 10+ questions          | Low regardless of count        |

## Method 3: Template-Based FAQ Pages[​](#method-3-template-based-faq-pages "Direct link to Method 3: Template-Based FAQ Pages")

If your team creates FAQ pages frequently — for example, every product release gets its own FAQ page — you can combine Modern FAQ with Confluence templates for a repeatable workflow.

### How to set up an FAQ template[​](#how-to-set-up-an-faq-template "Direct link to How to set up an FAQ template")

1. Go to **Space Settings > Templates** in your Confluence space
2. Create a new template
3. Add your standard page structure: title, introduction paragraph, and any boilerplate content
4. Insert the **Modern FAQ** macro into the template with placeholder questions
5. Save the template

When someone creates a new page from this template, the FAQ macro is already in place with the placeholder content. They just edit the questions and answers to match the specific topic.

This approach works well for teams that maintain:

* Product release FAQ pages
* Customer onboarding FAQ pages
* IT help desk FAQ pages per service
* Project-specific FAQ pages

## Best Practices for FAQ Pages in Confluence[​](#best-practices-for-faq-pages-in-confluence "Direct link to Best Practices for FAQ Pages in Confluence")

Regardless of which method you choose, these practices will make your FAQ pages more useful.

### Source questions from real data[​](#source-questions-from-real-data "Direct link to Source questions from real data")

The best FAQ pages answer questions people actually ask. Do not guess at what your users need. Instead:

* **Check your support ticket data.** The most common ticket categories should become FAQ questions.
* **Review Slack channel history.** Search for recurring questions in team channels.
* **Ask customer-facing teams.** Sales, support, and customer success teams know what customers ask most often.
* **Review Confluence search logs.** If your team searches for the same topic repeatedly, it belongs in an FAQ.

### Keep answers concise[​](#keep-answers-concise "Direct link to Keep answers concise")

FAQ answers should be 2-4 sentences. If an answer needs a long explanation, link to a detailed documentation page instead. The FAQ page is for quick resolution, not comprehensive documentation.

Bad: "To configure the API integration, first navigate to the settings page, then click on the integrations tab, then scroll down to the API section, then click the Add New Integration button, then enter your API key in the designated field..."

Good: "Navigate to **Settings > Integrations > API** and click **Add New Integration**. Paste your API key and click **Save**. See the [API integration guide](#) for detailed setup instructions."

### Group by topic[​](#group-by-topic "Direct link to Group by topic")

If your FAQ has more than 10 questions, group them by topic using section headers or separate FAQ macros:

* **Getting Started** — account setup, first steps, basic concepts
* **Features** — specific feature questions
* **Troubleshooting** — common errors and fixes
* **Billing** — pricing, invoices, plan changes

Each group can have its own Modern FAQ macro on the same page, keeping the content organized and scannable.

### Update quarterly[​](#update-quarterly "Direct link to Update quarterly")

FAQ content goes stale quickly. Set a quarterly reminder to review your FAQ pages:

* Remove questions that are no longer relevant
* Add new questions that have emerged
* Update answers that reference changed features or processes
* Check that all links still work

### Link to detailed docs[​](#link-to-detailed-docs "Direct link to Link to detailed docs")

Every FAQ answer should either fully answer the question in 2-4 sentences or link to a page that does. Do not leave readers halfway to an answer. If the FAQ answer is "it depends" or requires context, the link to the full documentation is the answer.

## Related Resources[​](#related-resources "Direct link to Related Resources")

* [Modern FAQ for Confluence](/apps/modern-faq-for-confluence.md) -- dedicated FAQ macro with drag-and-drop editing, two display themes, and WYSIWYG answer editing
* [Modern Questions for Confluence](/apps/modern-questions-for-confluence.md) -- community Q\&A forum with voting, accepted answers, and topic tags
* [FAQ and Q\&A Apps for Confluence Compared](/blog/faq-questions-confluence-comparison.md) -- side-by-side comparison of all FAQ and Q\&A apps on the Atlassian Marketplace
* [How to Build FAQ Sections in Confluence](/blog/how-to-build-faq-sections-confluence.md) -- design patterns and content strategies for FAQ pages

Try <!-- -->Modern FAQ for Confluence

Accordion-style FAQ sections with drag-and-drop reordering and two themes — free for up to 10 users.

[Get it on the Atlassian Marketplace](https://marketplace.atlassian.com/apps/1236739/modern-faq-for-confluence?utm_source=ngpilot.com\&utm_medium=website\&utm_campaign=modern-faq-for-confluence)

## Related guides

* [Confluence Questions & Answers Template](/blog/confluence-questions-answers-template.md)
* [How to Create Mermaid Diagrams in Jira](/blog/how-to-create-mermaid-diagrams-jira.md)
* [Export Jira Issues to Excel or CSV](/blog/export-jira-issues-to-excel.md)
* [Bulk Download Jira Attachments](/blog/bulk-download-jira-attachments.md)

Explore NGPILOT[Browse Solutions](/solutions.md)[All Apps](/apps.md)[Atlassian Marketplace →](https://marketplace.atlassian.com/vendors/1226848/?utm_source=ngpilot.com\&utm_medium=blog\&utm_campaign=hub-links)

**Tags:**

* [confluence](/blog/tags/confluence.md)
* [faq](/blog/tags/faq.md)
* [how-to](/blog/tags/how-to.md)
* [knowledge-base](/blog/tags/knowledge-base.md)
* [accordion](/blog/tags/accordion.md)
* [questions](/blog/tags/questions.md)