Questions Macro

Use the Questions macro to embed a short list of questions on any Confluence page. It is a read-only list with titles and answer counts, plus vote counts when your permissions allow it.

Add the macro

1. Edit a Confluence page
2. Type /Questions or use the + menu and search for Questions
3. Select Questions to insert the macro
4. Configure the options and click Save

Configure the macro

Space

• Defaults to the current space
• Leave blank to show questions from all enabled spaces

Tag

• Optional filter by tag
• Includes older questions that visibly have the exact tag even when Confluence search has not indexed that tag membership
• Recently created or edited tagged questions can also appear while Confluence search indexing catches up
• When a space is selected, the dropdown shows tags from that space
• When space is blank, the dropdown preloads up to 100 tags across enabled spaces (including global tags)
• Start typing to search tags across enabled spaces

Filter

• All
• Unanswered - questions with no answers
• No accepted answer - questions that may have answers, but none is accepted

Sort by

• Newest
• Votes

Questions shown

• 5, 10, or 15

Voting permissions and sorting

If you do not have permission to view votes in a space, vote counts are hidden for questions from that space. When sorting by votes is not allowed, the macro falls back to newest.

View all questions

The macro includes a View all questions link:

• For a specific space, it opens that space's Questions view
• For all spaces, it opens the global Questions view if enabled

Troubleshooting

If questions are not enabled in the selected space, or you do not have permission to view them, the macro shows a message instead of a list.

If there are no matching questions, you will see "No questions found."

A tagged macro checks one bounded page of up to 200 visible question candidates and immediately shows every verified match it finds, up to the configured 5, 10, or 15 maximum. If more candidates could add or change the displayed results, select Check more questions to check one additional page. You can repeat this while the button remains available. Existing results stay visible, including when a checked page has no additional match.

If checking another page fails, the current results remain visible with "Could not check more questions. Try again." Select Check more questions to retry. "Unable to load questions" is reserved for a full request or data-loading failure.