Workbooks for Confluence User Guide
Updated: 2 days ago
Version 2.1.0 | Published by BONUM LLC
Create. Learn. Measure.
1. Welcome to Workbooks for Confluence
Workbooks for Confluence transforms Confluence Cloud into an interactive learning workspace. Teams can create guided learning experiences, practice new skills, complete activities, and monitor learning progress without switching to a separate learning management system.
The application supports 17 interactive activity types, optional Atlassian Rovo-assisted workbook creation, external learning resources, and progress reporting. Workbooks is designed for employee onboarding, workshops, internal training, professional development, and practical skills reinforcement.
Who can use Workbooks?
Workbook creators: Design, edit, publish, duplicate, and manage workbooks.
Learners: Access published workbooks, complete activities, and save progress.
Facilitators: Use workbook results to monitor completion and practice scores for workbooks they own.
Confluence administrators: Manage installation, subscriptions, and application availability within their organization's Atlassian environment.
2. Requirements and Installation
Workbooks for Confluence is designed for Confluence Cloud and is distributed through the Atlassian Marketplace.
Administrator setup
Open the Atlassian Marketplace.
Search for Workbooks for Confluence by BONUM.
Open the app listing.
Select the available installation or trial option.
Choose your Confluence Cloud site.
Review the requested application permissions.
Complete the installation and licensing process.
An authorized Atlassian administrator may be required to approve the installation. After installation, open Workbooks from your Confluence application's navigation.
Note: Workbooks is a paid Marketplace application. Trial and subscription availability are governed by Atlassian's applicable billing terms.
3. Understanding the Workbooks Workspace
The application is organized into three main areas.
My workbooks
The author workspace provides tools for creating, editing, organizing, and publishing workbooks. Creators can manage their workbook library, search for existing workbooks, create new workbooks, and access optional Rovo-assisted authoring.
Learn
The learner workspace provides access to published learning experiences using a course code.
Learners can complete activities, save their responses, and resume supported workbooks.
Results
The Results workspace displays completion information and practice scores for workbooks owned by the authenticated creator. Reporting includes participation, completion, and assessment summaries rather than exposing the learner's complete private notes and reflection records.
4. Creating Your First Workbook
Workbooks can be created manually or through optional Rovo assistance.
Create a workbook manually
Open My workbooks.
Select + New.
Enter the workbook's title and other available details.
Open the Activities step.
Add learning and practice activities.
Configure each activity's title, instructions, and content.
Save the workbook as a draft.
Review the workbook using Preview.
Publish the workbook when it is ready for learners.
Workbooks remain drafts until explicitly published.
Organize your activities
The activity editor allows creators to arrange learning blocks into a logical sequence. Where available, use drag-and-drop controls or the up and down buttons to reorder activities. Creators can also duplicate activities and remove blocks that are no longer needed.
Recommended workbook structure
For a short training experience, use:
A brief introduction explaining the learning goal.
One or two guided learning activities.
An interactive practice exercise.
A knowledge check.
A reflection or action-planning activity.
Keep instructions concise and organize activities in the order learners will use them.
5. Interactive Learning Activities
Workbooks includes 17 supported activity types across its authoring tools. The activity library supports different instructional purposes, including guided lessons, knowledge checks, reflection, matching, sequencing, card-based exercises, and action planning.
Examples include:
Short lessons: Introduce concepts, explain procedures, or provide background information.
Knowledge checks: Let learners assess their understanding of material.
Matching pairs: Ask learners to connect related concepts, terms, or definitions.
Sequencing: Let learners arrange actions or steps into the appropriate order.
Reflections: Encourage learners to consider how information applies to their work.
Action planning: Help learners identify practical next steps.
Creators should select activities based on the learning objective rather than using multiple activity types simply for variety. The complete set of 17 activities is available in the Workbooks activity selector.
6. Creating Workbooks with Atlassian Rovo
Workbooks includes optional integration with Atlassian Rovo to assist with workbook draft creation.
Generate a workbook draft
Open My workbooks.
Select Create with Rovo.
Describe the learning objective, target audience, and desired learning experience.
Review the proposed workbook content.
Ask Rovo to create an editable draft.
Return to the Workbooks library and refresh it if the new draft is not immediately visible.
Open the draft, revise its content, and preview the learner experience.
Rovo-assisted creation is optional. Workbooks can also be authored manually.
Example prompt
Create an interactive onboarding workbook for new Confluence users. Include a short introduction, practical activities, a knowledge check, and a reflection. Keep the instructions beginner-friendly and save it as an editable draft.
Important considerations
AI-generated content should be reviewed before publication.
Verify instructions, examples, and factual statements.
Confirm that activities are appropriate for the target audience.
Avoid providing unnecessary personal or confidential information.
Creating a draft with Rovo does not automatically publish it.
Rovo availability depends on the customer's Atlassian environment, permissions, and applicable AI service capabilities.
7. Adding Videos and External Learning Resources
Workbooks supports learning materials from several external services. Supported video providers include:
Atlassian Loom
YouTube
Vimeo
Creators can also reference supporting resources such as Confluence pages and Jira issues.
Adding video content
Where the selected activity supports video content:
Open the workbook in the activity editor.
Select the appropriate activity or content field.
Enter the supported video URL.
Save the activity.
Preview the workbook to verify that the video is accessible.
Video playback availability may depend on the original provider's privacy settings, embedding restrictions, browser policies, and organizational permissions.
Using Loom transcripts
Loom transcripts or related instructional text can be used as supporting learning content where the author has appropriate access and permission. Review transcripts before including them in a workbook, especially if they contain names, customer information, meeting discussions, or confidential organizational content.
Adding Confluence and Jira references
Include links to relevant Confluence documentation or Jira issues where those references support the learning activity. A link does not automatically grant the learner access to its destination. Learners must have the required permissions in the connected Atlassian product.
8. Previewing and Publishing a Workbook
Before publishing:
Confirm the workbook title and learning objective.
Check the sequence of activities.
Review the clarity of instructions.
Test the interactive exercises.
Check videos and supporting links.
Review the experience from the learner's perspective.
Save any required changes.
When the workbook is ready, select Publish. Publishing makes the configured workbook version available to learners through the application's supported sharing process. The workbook creator remains responsible for deciding when a draft is ready for release.
9. Sharing a Workbook with Learners
Published workbooks can be accessed using a six-character course code.
For creators
Open the published workbook.
Navigate to Share.
Locate its course code.
Provide the code to the intended learners.
Share course codes through your organization's approved communication channels.
For learners
Open Workbooks in Confluence.
Select the Learn tab.
Enter the course code provided by the facilitator.
Select Open workbook.
Begin the learning activities.
Learners must be authenticated through their Atlassian account. A course code provides access to the published learning experience; it does not grant permission to edit the source workbook or view another learner's private activity records.
10. Completing a Workbook
The learner interface displays the activities associated with the selected workbook. Learners can move through the material using the activity navigation and the Previous and Next activity controls.
Depending on the activity, learners may:
Read instructional content.
Enter notes or reflections.
Select responses.
Match related information.
Arrange items in sequence.
Check their answers.
Mark an activity complete.
Review completed work.
Saving progress
Workbooks is designed to associate saved progress with the authenticated Atlassian account. Learners should confirm that progress has saved successfully before leaving the application. If the interface reports a cloud-saving error, use the available progress download or backup option and contact support before relying on the saved state.
Resume learning
Returning learners can reopen supported saved workbooks and continue their activities. If the published workbook has changed since the learner began, the application may indicate that the saved copy differs from the latest published version.
11. Learning Scores and Results
Workbooks provides progress and practice-score reporting.
For learners
Learners can complete activities, review supported feedback, and track their own progress. Scoring varies by activity type. Some activities are designed for reflection or practice rather than scored assessment.
For workbook creators
The Results tab displays reporting information for workbooks the user owns.
Available information may include:
Learner Atlassian account identifier
Workbook version
Completion percentage
Practice score
Completion status
Last updated date
Creators can select a workbook to review its results and use Export CSV where available.
Reporting limitations
Workbooks' practice scores are intended to support learning and feedback. They are not designed as secure examinations, professional certifications, or independently validated employee performance assessments. The current learner interface may expose information needed to evaluate practice responses, so results should not be used as high-stakes certification evidence.
12. Learner Privacy and Data Security
Workbooks uses Atlassian Forge and Forge SQL to store workbook and learning records. Stored information may include workbook content, Atlassian account identifiers, learning responses, progress records, completion information, and practice scores. The application is designed to restrict author reporting to workbooks owned by the authenticated creator.
Standard creator reports display progress and scores rather than reproducing the learner's complete private notes. Creators and learners should avoid entering unnecessary sensitive or confidential information. External video services may process browser-level information under their own privacy policies.
For additional information, review the BONUM Privacy Policy and Terms of Use: https://www.unifiedaiadoption.com/privacy
13. Managing Workbook Content
Edit a draft
Open the workbook from My workbooks, make the required changes, and save it.
Duplicate a workbook
Use Duplicate to create a separate copy that can be adapted for another audience or learning experience.
Edit a published workbook
Creators can revise their workbook content and publish an updated version when ready. Learners who started an earlier published version may have saved progress associated with that version.
Delete a workbook
Use the available deletion control when a workbook is no longer needed. Deletion may affect access to associated workbook records. Export or retain any information your organization needs before deleting content.
14. Troubleshooting and Frequently Asked Questions
Q: I created a workbook with Rovo, but it is not appearing
A: Return to My workbooks and select Refresh library. If the workbook still does not appear, verify that Rovo completed the draft-creation action and that you are signed in to the correct Atlassian account and site.
Q: My course code does not work
A: Confirm that the code contains six characters and was entered correctly. Ask the workbook creator to verify that the workbook is published and that the code is current.
Q: My progress did not save
A: Check the application's save-status message. If cloud saving fails, use the available progress backup option, avoid discarding your work, and contact your organization's administrator or BONUM Support.
Q: I cannot open a Confluence or Jira link
A: Check whether your Atlassian account has permission to access the linked content. Workbooks does not override existing Confluence or Jira access permissions.
Q: A video does not play
A: Verify that the video is accessible through its original provider and that its privacy settings permit viewing or embedding. Browser settings and organizational security policies may also affect playback.
Q: I cannot see another creator's results
A: Results reporting is designed to be restricted to the workbook's owner. Having access to a published workbook does not automatically grant reporting or editing access.
Q: Can I create a workbook without Rovo?
A: Yes. All standard workbook creation and editing functions can be used independently of Rovo-assisted authoring.
Q: Can Workbooks automatically create Jira tickets or assign training?
A: Automatic Jira ticket creation, score synchronization to Jira, and automated learning assignments or reminders are not included in the initial release.
15. Support
Publisher: BONUM LLC
Product: Workbooks for Confluence
Supported platform: Confluence Cloud
Support email: admin@urbonum.com
When requesting support, include:
A description of the issue.
The activity or action being performed.
The relevant workbook title or course code, when appropriate.
Any error message displayed.
A screenshot, if useful and permitted by your organization.
Do not send passwords, access tokens, confidential learner responses, or other unnecessary sensitive information in support requests.
16. Additional Resources
Atlassian Marketplace
Unified AI Adoption
Privacy Policy and Terms of Use
Atlassian Cloud Support
Workbooks for Confluence is developed by BONUM LLC as an independent Atlassian Marketplace application. Atlassian, Confluence, Jira, Rovo, and Loom are trademarks or products of their respective owners. © 2026 BONUM LLC. All rights reserved.




Comments