Engage for Confluence User Guide
Engage for Confluence turns knowledge-sharing sessions into interactive games, polls, and learning activities without leaving Confluence. Create activities, run presenter-led Live Play sessions, invite teams to compete, offer Self-Paced participation, and review session reports. Optional Atlassian Rovo assistance can help draft activities for review.
Who this guide is for: Activity creators, presenters, participants, and Confluence administrators. Access requires an authenticated Confluence account and installation of Engage on your organization’s site. Rovo features require Rovo availability on that site.
1. Getting started
In Confluence, open Apps and choose Engage for Confluence. Your administrator may need to install or enable the app first.
The home page has two main areas: Join an activity (left) and My activities (right).
To join an existing activity, open its Confluence link or enter its room code under Join an activity and select Open activity.
To author an activity, select + Create activity. Activities you have saved appear under My activities.
The organization’s administrator controls access to Confluence. Engage uses the signed-in Atlassian account to associate a person with their activity participation; a room code alone does not provide anonymous access.
2. Create an activity
In My activities, select + Create activity.
Enter a meaningful Activity name (for example, “Cybersecurity Basics” or “Employee Pulse Poll”).
For each question, choose an Activity type and enter the Question or instruction.
Add or edit response choices, correct answers, sequences, or matching pairs as appropriate for that type.
Use + Add question to build a multi-question activity. You can Move up, Move down, or Remove questions to refine the sequence.
Select Save activity. The saved activity is a reusable draft; saving does not start a game or make a published session.
Use Edit to revise the saved activity or Publish to launch a new session from it.
A saved activity may contain up to 50 questions. The editor accepts up to eight choices or matching pairs where applicable. Complete all required text and answers before saving.
Available game and activity types
Type | What participants do | Scored? |
Multiple Choice | Select one answer | Yes |
True / False | Choose True or False | Yes |
Multiple Select | Select all applicable answers | Yes |
Ranking | Move options into the correct order | Yes |
Matching Pairs | Match items with their corresponding partners | Yes |
Audience Poll | Vote on a choice | No |
Word Cloud | Submit one word or short phrase | No |
Global Connections Map | Voluntarily choose a country or territory | No |
Word Cloud responses support discussion. The map does not infer a participant’s location from GPS or IP address. Unscored activities count toward completion but do not award points.
3. Optional: create an activity with Rovo
On the home page, select Create with Rovo if the button is available.
Tell the Engage activity assistant the topic, intended audience, and learning or engagement goal.
Review the drafted questions and answers. Ask for revisions when needed.
When satisfied, use the assistant’s save-draft action to create an unpublished activity under My activities.
Return to Engage, select Refresh my activities, and Edit the saved draft before publishing.
Rovo availability depends on your site’s Atlassian configuration. AI-generated material can contain mistakes; creators are responsible for verifying factual accuracy, appropriate answers, and suitability for the audience. Rovo drafts are not automatically published.
4. Choose session settings and publish
On the home page, configure Activity settings before selecting Publish beside a saved activity. Settings apply to the next published session, not retroactively to earlier sessions.
Setting | Options and behavior |
How will participants complete this activity? | Live Play — presenter-led or Self-Paced — independent |
Participation mode (Live Play) | Individual Play or Team Play |
Team names (Team Play) | Enter names separated by commas |
Team assignment (Team Play) | Participants choose teams, or Engage automatically balances teams |
Hide player names | Masks names in public displays and reports/exports where supported; does not make participation anonymous to the system |
No time limit (Live Play) | Removes the question countdown |
Time per question (Live Play) | 10 seconds or 30 seconds when the timer is enabled |
Show results to participants (Self-Paced) | Controls visibility of aggregate results |
Select Publish for the activity you want to use. Engage creates a distinct published session with its own room code, settings, and response data. Reusing an activity creates another session; earlier session results remain separate.
5. Invite participants
Open the published session from Published sessions.
Select Copy activity link and send the link through your usual Confluence/team communication channel. You can also share the room code.
Participants open the link or enter the code under Join an activity.
Participants may enter a nickname when player names are visible. If Team Play is enabled with participant-selected teams, they choose a team before joining.
Select Join activity.
Each participant must sign in to Confluence. Existing published sessions may have longer room codes; newer sessions use shorter six-character codes.
6. Host a Live Play game
The creator or designated presenter opens the session and uses Presenter controls:
Select Start game when the participants are ready.
Present the question while participants submit answers from their own Confluence accounts.
Select Pause or Resume if you need to interrupt a timed question.
Select Reveal results to close the question and display results.
At the midpoint, select Show halfway standings when offered.
Select Next question to continue.
On the final question, select Show final standings, then Finish when ready.
Use Presentation view for a more prominent display during a meeting; select Exit presentation view to return. A presenter can see an answer preview that ordinary participants cannot access before the permitted reveal.
Team Play and leaderboards
With Team Play, participants are assigned to or choose a team before the game begins. Team standings are based on the average earned points of active participants, where “active” means a participant who answered at least one question. Individual and team leaderboards appear at the halfway and final checkpoints, rather than continuously throughout the game.
Presenter handoff and recovery
The current presenter can choose a joined participant in Transfer presenter control, then select Transfer control. The original session creator can use Take back control to recover presenter duties if needed. If a browser is refreshed or closed, reopen the activity from Published sessions or its room code to return to the ongoing session.
7. Complete a Self-Paced activity
When a creator publishes a Self-Paced session, participants can work through it without waiting for a presenter:
Open its link or room code, then select Join activity.
Answer each question and select Submit response.
Use Previous and Next activity to navigate, or Go to next unanswered question to continue.
The progress area tracks saved responses, completion percentage, and points from scored questions.
Once all questions have responses, the activity displays a completion message. Participants can return to their saved activity.
The creator can use Close activity to stop collecting responses. Self-Paced sessions do not use team competition in the current release.
8. Review results and export reports
The activity creator can open a published session and select View session report, or use View report from the session’s three-dot menu. Reports show:
Joined: number of participants who entered the session
Responded: number who submitted at least one response
Completed all questions: number who answered every question
Average points (respondents): average points across participants who responded
Question results: response counts and correct-response counts (where scoring applies)
Participant progress: questions answered, completion status, and points
Use Export participants CSV or Export questions CSV to download reporting data for analysis. For sessions configured with hidden player names, names are masked in the exported participant report. Polls, Word Clouds, and Global Connections Map responses do not award points even though their submissions contribute to completion.
Reports reflect actual participation. A newly created session may legitimately display zero participants, responses, and points.
9. Manage saved activities and published sessions
Saved activities — under My activities
Edit: Change a saved activity.
Publish: Create a new live or self-paced session using the currently selected settings.
Duplicate: Make a separate reusable copy.
Archive / Restore: Remove an activity from normal active authoring without immediately deleting it.
Delete activity: Permanently delete the saved activity after confirmation. Previously published sessions and their responses remain available.
Published sessions — under Published sessions
Filter Active, Archived, or All sessions.
View session: Reopen the session.
View report: Review participation and results.
Archive session / Restore session: Change visibility in session lists when the session status permits.
Reset responses: For a finished session, permanently clear its participants, answers, and scores after entering the room code to confirm. The session remains closed.
Delete published session: Permanently delete an eligible published session following confirmation.
Important: Resetting or deleting session data is not reversible. To run a new class using the same questions, publish a new session rather than resetting old results.
10. Privacy, access, and data handling
Engage runs within Atlassian Confluence Cloud and uses Atlassian-hosted Forge services, including Forge SQL. It records participation against authenticated Atlassian accounts. Depending on session settings, records may include account identifiers, display names, team membership, answers, scores, completion status, and session timestamps.
Hide player names masks identifiers in public-facing displays and supported reports; it is not anonymous participation. The Global Connections Map uses a voluntary country/territory choice, not automatically detected location. Do not place confidential or inappropriate personal information into activity questions, Rovo prompts, Word Cloud submissions, or public session content.
Saved activities and session data persist until they are deleted through available controls; do not assume the app automatically erases submissions after a short period. For formal retention, deletion, security, or DPA commitments, refer to BONUM LLC’s published app privacy documentation and your organization’s policies.
11. Troubleshooting
Problem | What to try |
I cannot find Engage | Ask your Confluence administrator whether the app is installed and your account has access. |
Room code is not recognized | Check the exact code, confirm you are on the right Confluence site, or ask for a fresh activity link. |
I cannot join | Make sure you are signed in and follow the Join activity prompts; the session may already be closed. |
The presenter cannot advance | Confirm you are the current presenter; reveal the results before moving to the next question where required. |
Rovo button is missing | Rovo may be unavailable or disabled on your site. Create the activity manually instead. |
My saved Rovo draft is missing | Select Refresh my activities; check the correct Confluence account and site. |
Answers or standings do not update immediately | Reopen or refresh the room; Engage uses realtime updates with periodic refresh as fallback. |
My report is empty | Verify that participants joined and submitted responses in that specific published session. |
My draft will not save | Enter a meaningful activity name and complete required question content and answer choices. |
The app says data is initializing | Contact your Confluence administrator or BONUM support if the installation continues to show setup errors. |
12. Support and additional information
Publisher: BONUM LLC
Product: Engage for Confluence (Confluence Cloud)
Documentation: This guide
Privacy and data protection: https://www.unifiedaiadoption.com/privacy
For technical issues, contact BONUM LLC through the support contact or ticketing system published on the Engage for Confluence Atlassian Marketplace listing. Include the Confluence site, relevant room code, approximate time, and error message, but do not send passwords or confidential participant answers.
Availability may vary by Atlassian permissions, licensing, Rovo availability, and subsequent releases.




Comments