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
• 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

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."