K15t | Unleash the Potential of Your Products (2024)

Does your customer support team receive the same questions over and over again? If so, it’s time to give your users and customers what they need – a Frequently Asked Questions (FAQ) page.

In this blog post, you’ll find some tips and examples that will help you create and manage your very own FAQ collection in Confluence which you can then publish as a publicly available help center.

Confluence for Knowledge Management and FAQs

A customer recently asked me the best way to build an FAQ page in Atlassian Confluence. Was there a standard method they could use? Confluence ships with atroubleshooting article templatethat allows users to easily capture useful information and create a knowledge base. What it doesn’t include, though, is an FAQ page blueprint or template.

FAQ collections provide users with answersto common issues. And Confluence is a central source of corporate knowledge, so it’s the first place users will turn to when looking for help. Readers expect to find at-a-glance solutions – short, to-the-point and free of sales jargon. Let’s find out how to build an FAQ collection that gives them exactly what they want.

Getting Started With A Single FAQ Page

The easiest way to create an FAQ collection is to put all your questions and answers on a single page. This works particularly well if all the questions relate to the same topic – such as purchasing and licensing – and the answers are relatively short and simple.

To keep the page clutter-free, I recommend making your answers collapsible. If you're using Confluence Data Center or Server, you can use our freeExpando app.It's a useful macro that allows you to expand page sections with a single click. Alternatively, you could use the standard ConfluenceExpand macro.

Each FAQ Entry on a Separate Page

You’ll need multiple question categories for more complex topics – such as when differentiating between products, business scopes, or other subjects. In addition, you’ll need aconsistent content structurefor more detailed answers.

For these subjects, it’s better to create an overview page that lists the FAQ sets at a glance, and a separate Confluence page for each question.By using acustom page template, you can ensure the pages follow a standardized structure:

• The page title containing the question.
• A rich-text area where authors can enter more detailed text, e.g. information, examples, and additional descriptions.
• The answer, which may contain rich-text formatting, images, tables, etc.
• Related pages,using theContent by Label macro.
• A label 'FAQ', accompanied by a label that corresponds to the question category, e.g. 'product_a".

Providing anFAQ Overview Page

You’ll need to create an overview page that consolidates all of your question/answer pages.

Using the Children Display macro

If your FAQ has too many questions to fit on a standard screen, I suggestadding each page into a Children Display macro:

This works especiallywell if you want to publish your Confluence documentation as a help center using Scroll Viewport. Once published to a help center, the table of contents appears as an easily navigated list for your readers. They can then click on the question that's most relevant to them to go to that page:

But if your FAQ page is just going to be viewed in Confluence, it's good practice to use a three-column layout, andto group child pages of a specific type using theContent by Label macrothat lists all pages within a category (that also have the ‘FAQ’ label).

Using the Content by Label macro

Alternatively, you could use theChildren Display macroto display the hierarchy of subpages at a glance.

ARecently Updated macrowill help frequent visitors quickly access the latest changes in your FAQ collection.

Advanced FAQ Structure Using Page Properties

There may be some instances where you want to add some criteria to each question page. For example, to note the target audience, or to track the dates in which the content is valid. To do this, I recommend adding a table to each page with the criteria of interest, and placing it inside aPage Properties macro.Thismacro letsyou define tabular metadata for Confluence pages, which you can use to enhance your FAQ overview page.

With criteria on each question page, consider adding the correspondingPage Properties Report macroto your FAQ overview page.In this example, you could use the macro to display the validity period of the information provided, or to differentiate between target audiences.

Managing User-Generated Q&A Content With Questions for Confluence

Another even more collaborative approach is to move from FAQs to Q&As, by crowd-sourcing both questions and answers. That's the main purpose ofQuestions for Confluence. This Atlassian applets Confluence users ask questions, while their colleagues and fellow users provide the answers. In addition, users can rate responses – so the best answers rise to the top of the page.

If you want to consolidate knowledge from across your entire organization and create a Q&A expert community, Questions for Confluence is the perfect choice.

Anything Else?

Now you’ve got all the information you need to create FAQs in Confluence. But why stop there?

• Create FAQ page templates that already have the corresponding labels and/or page properties.
• You could develop a Confluence page blueprint that automates FAQ page creation, and provides a step-by-step configuration wizard.
• If using internally on Confluence Data Center, integrateuser ratingsthat show you just how helpful your users find the FAQ pages.
• Export your FAQ collection as aPDF or Word document, so everyone can access it in the format they require.

Providing an FAQ section in Confluence makes this collaboration platform even more attractive to your user base, especially when your FAQs are published as an online help center.

A Scroll Viewport help center built from your Confluence documentation allows your users to search for helpusing the powerful built-in search functionality. Your help center will also be indexed by search engines such as Google, so your articles can be found by your users from a quick Google search too.