Showing results for 
Search instead for 
Did you mean: 
Community Team
Community Team

Canvas Release: MasteryPaths (2016-11-19)

This document introduces the Canvas MasteryPaths feature as noted in the Canvas Beta Release Notes (2016-11-07) and Canvas Production Release Notes (2016-11-19). MasteryPaths is available in all regions worldwide.


MasteryPaths requires the Mastery Paths feature option in account settings, which can be enabled by any Canvas admin. When allowed at the account level, the feature can be enabled on a course-by-course basis.


When enabled for a course, MasteryPaths affects Modules and items in Assignments, Discussions, Quizzes, and Pages.


The Canvas MasteryPaths feature allows instructors to customize learning experiences to students based on student performance. MasteryPaths is based on differentiated assignments, an existing Canvas feature. Instructors and course designers can identify activities for each student’s learning path and differentiate assignments for required learning, optional learning, or choosing their own content and assignments within a specific path. All assignments and pages should be created before publishing course content to students.



Account Setup

MasteryPaths requires the Mastery Paths feature option in account settings, which can be enabled by any Canvas admin. When allowed at the account level, the feature can be enabled on a course-by-course basis.


Additionally, a new admin, Conditional Release API, will be added to all Canvas accounts by default. This admin should not be removed for accounts that want to use MasteryPaths, otherwise MasteryPaths will not work correctly. The API will be removed as an account admin in a future release.


Modules Setup

The MasteryPath process currently only originates from the course Modules page. Before a user creates conditional assignments, all course assignments and pages should be developed and added to Modules as module items. MasteryPaths can be created from module structures in existing courses or new course content.


Indenting module items can be used to help organize the modules structure and visually show which items should be part of a MasteryPath.




Modules Requirements and Prerequisites

Module requirements and prerequisites are not specifically required for MasteryPaths. However, setting requirements may be helpful for students to see the scope of the course and emphasize course organization.


Assignment Content

Any graded assignments, graded discussions, and quizzes in a module can be the source for a MasteryPaths item and can also be set as conditional assignments directly from the module.


Module items that cannot be used in MasteryPaths include ungraded assignments, ungraded discussions, practice quizzes, and surveys (both graded and ungraded).


Page Content

Because pages do not require grading, pages cannot be the source of a MasteryPath and can only be added to an assignment as conditional content. However, a page must be edited and set up as a MasteryPath item before it can be added to a conditional path.


To enable a page for MasteryPaths, open the page from the module. After editing the page, select the Allow in mastery paths checkbox. This checkbox allows MasteryPaths to select the page as a conditional item. Otherwise, the page will not display as an option for conditional content.





MasteryPaths Creation

To create a conditional assignment, begin with a module assignment that should be required by all students. Such items can include a pre-test or an introductory assignment that act as foundation for a student’s learning. The assignment’s Settings menu displays a MasteryPaths option, which accesses the MasteryPaths configuration page for the item.


Note: Items that cannot originate a MasteryPath, such as pages, as well as items that do not support MasteryPaths will not display the MasteryPaths settings option.




Configuration Page

The MasteryPaths configuration page allows instructors to add additional items in the modules list as conditional items that are only assigned to specific students through conditional rules. The configuration page for a conditional item is located in the item’s MasteryPaths tab.


Note: The MasteryPaths tab is available in assignments, discussions, and quizzes, so additional content around the tab may vary.





Conditional Rules

Conditional content is created based on a set of rules in three scoring ranges. After the initial assignment has been graded by the instructor, the student’s score designates which conditional items(s) will be assigned as a learning path. For instance, a student who scores above 90% on an assignment could be assigned more advanced work, while a student who scores below 60% could view assignments designed for content clarification and improvement.


The ranges display according to the display set for the assignment—points, percentage, letter grade, or GPA. The three ranges default to 70%, 40%, and 0% of the assignment’s point value, rounded up respectively. For instance, an assignment worth 25 points defaults to ranges of 25–18 points, 18–10 points, and 10–0 points. However, each range can be customized to a range outside the default values by clicking the value and making the preferred adjustment.




Any existing item in the course can be added as additional content. To add conditional content, select the range where the conditional content should be created and click the Add button. In the content window, select the item(s) that should be added for the selected range. Content can be searched by name, or in the adjacent drop-down menu, items can be filtered by type. If a content item does not display in the content window, the item cannot be added as a conditional release item.




If additional items are added to a range at a later time, any item already added in the range will be crossed out.


Note: Pages will not display as a conditional item unless the page was edited to be included as a MasteryPath item.


And or Or Setting

Up to three existing items in a course can be added to each range, either in the form of individual items or groups. When more than one item is added to the same range, the items default to be completed together as indicated by the And (ampersand) symbol. Students who complete the assignment and score in a range with joined assignments must complete all the assignments in the conditional path.


However, the path can be set to complete only one item or group in the path by clicking the And symbol, which separates the items and displays an Or button. Students who complete the assignment and score in a range with an Or designation can select which item(s) to complete as part of the conditional path.


Multiple items within a range can be mixed and matched as individual items, grouped items, or both. Items can also be reordered within the range by dragging and dropping in the preferred order.




Item Management

Each item includes an options menu for quick access to edit the item, move the item, or remove the item from the conditional path. Items can also be moved to another range by drag and drop.




If necessary, users can delete multiple items at once by hovering over each item, selecting the check mark, and clicking the Delete key on their computer keyboard. This behavior will be adjusted to support additional bulk functionality in a future release.





  • Added items can include due dates, but due dates are controlled by each individual item, not by the conditional path. Instructors may want to confirm any assigned due dates for conditional items are aligned with the rest of the coursework appropriately in the module page structure.
  • If conditional items are added to a path and later changed (such as separating conditional items in the same range or adding another item), the change will not apply to any students who have already been graded based on the original conditional path. Conditional items should be final when course content is published.


Index Page Assignment Indicator

Once the assignment is saved, the assignment displays a MasteryPaths link in the Modules page. This link is also displayed in the assignment's respective index page—Assignments, Discussions, and Quizzes, respectively. When selected for an individual item, the MasteryPaths link directly opens the configuration page for the item.




Conditional items also display the Mastery Paths indicator showing the range that triggers the release of the item. If an item includes multiple ranges, the MasteryPaths indicator shows there are multiple ranges.


Note: The same item may be added to more than one source MasteryPaths assignment.




Conditional assignments can also be set up as their own MasteryPath source. These assignments show both the MasteryPaths link and the conditional range of the item where it was already added.




Differentiating Assignments for MasteryPaths

By default, assignments in Canvas are assigned to Everyone, which means all students will be able to view the item in their Modules page. All content items added to a MasteryPath should be set as a differentiated assignment for MasteryPaths, as it is only meant to be distributed as a conditional assignment.


For each conditional assignment, open the assignment and view the Details tab.






In the Assign field, remove Everyone from the item and replace it with the MasteryPaths option. The Mastery Paths assignment designates the assignment for conditional release only, and the assignment will only display to students whose scores fall in a range that releases the assignment to them.




Student View

Once Modules and their content have been published, instructors can use the Student View feature in their course to view Modules as students will see them. The only course items that should be visible are items assigned to Everyone. If a conditional item is displaying in student view, the assignment may not have been edited to become a differentiated assignment for MasteryPaths.





Student Workflow

For students, Modules only shows items that have been published and assigned to Everyone or assigned specifically to an individual student.




Conditional items are automatically included in the module once the instructor has graded the source MasteryPath item. Once the assignment has been graded, the conditional item(s) will display in the student’s Modules page based on the item’s scoring range.


Note: When students complete a MasteryPath assignment that requires any manual grading, and module items are required to be completed in order, the item is shown as being locked until the assignment is graded.


Conditional Item Options

If a conditional path allows students to choose an assignment, students are shown that they must choose an assignment. They can select which option they prefer for their assignment path.




Additionally, when a student is assigned or selects a conditional item, the conditional assignment automatically adds the student’s name to the assignment as being differentiated to that student.


Note: If an instructor regrades an assignment after a student chooses a mastery path option, and the regrade puts the student’s grade in a different conditional rule group, the student will have to choose another mastery path option and complete it before advancing through the module.


Instructor Assignment Sidebar Summary

Once students complete a specific assignment, instructors can view the breakdown of the mastery path ranges in the assignment. Each range includes a link that shows the number of students who scored in each range. Instructors can click the name of a student in the range, view the student’s score and submission, and send a message to the student.



Labels (1)
99 Replies

Does anyone have any insights yet as to the functionality of module prerequisites and mastery paths working in conjunction. Imagine a scenario in which a student is working through Module X with requirements and mastery path-driven conditional assignments. There is a second module (Module Y) with a prerequisite of completion of Module X to unlock.

path case instance.png

How can a teacher prevent a student who takes the quiz in Module X from being able to move to Module Y (bypassing the Intervention or Extension assigned to their path)? I don't see how a teacher can assign the Intervention and/or Extension as Module X requirements because they don't need to complete both. Obviously, in any kind of competency-based model, we don't want teachers to lock down modules by putting availability dates on them or unpublishing them because that will prevent those students, who are ready to move on, from moving forward along their accelerated learning path.

Thoughts that come to mind are adding a 'Conclusion' page, or something to the path that would be required along both the intervention and extension paths. Something like this:

path 2.png

This seems to work in Student View, but a bug actually pushes the student from quiz results directly to Volume Conclusion page (and on to Module Y, if desired), without completing the intervention . . . I'd assume that bug fixes will eventually address this, so that's not my immediate concern.

Any other thoughts out there related to this scenario? Thanks!  @jholland1 ​

Navigator II

Hi Stephen,

I don't think you have to put the Conclusion item in the paths when the module has everyone to complete all items. Meaning, if mastery paths were not in place, they would have to view the Conclusion item anyway in order to complete the module.  And I do very much like the idea of a conclusion item.

I've also taken to putting a What's next page thingie after the Mastery Paths determining item, so that when the students click Next in the module, they are taken to a page to explain what is going to happen with their next (mastery path) tasks--instructions to click back to Modules to see what's available to them. But I do not know what happens if you add module requirement to those next up tasks. Part of me believes if those both mastery path assignments from your example were marked as required that the student would not be able to have the module counted as complete since they were only shown one of the two items in their path.

Thanks for the Conclusion item idea!
Cheers - Shar


'What's next' explainer is a good idea, especially until bugs are fixed - thanks!

Community Team
Community Team

Hi, Stephen,

The best way to ensure that students cannot progress ahead of any course content is to use module prerequisites and set a requirement for each module item. And prerequisites should include each module that comes before the module where you are setting the prerequisite.

And yes we are still working on the bug fixes for the page display. Smiley Sad

Hope that helps,


Community Team
Community Team

Hi, Michael,

Yes this sounds like the workflow behavior we have where there is a delay in the assignment release in the Modules page. Engineers are looking into this.



Community Team
Community Team

If you RSVP'd to the aforementioned Mastery Paths event, you know that it was rescheduled: the CanvasLIVE event K12 Study Hall: Individualized Learning with Mastery Paths will now take place on Tuesday, December 13, 2016. That's the value of your RSVP! As always, RSVP “yes” if you will be there--and if you’re interested, but your schedule doesn’t allow you to attend in real time, RSVP "no" or "maybe" to receive all event updates.

Community Member


I am having this error as well. I have submitted the form as requested. I have enabled the Mastery Paths in the Admin settings for all courses. However, the error still occurs. Is there anything additional that must be done to enable this function?

Community Team
Community Team

Hi, Tyler,

The beta refresh from this weekend is causing some sadness in beta and our engineers are working to get it resolved.



Community Team
Community Team

Hi, everyone,

We're getting close to the comment limit for this document (so sad), but all current behaviors are documented here and our engineering team is working hard to resolve them. I'm going to close these notes for now, and any additional updates will be added to a future version of the release notes. I'll also update this document as changes are made as well so the information is current.



Community Team
Community Team

Hi, all,

We're happy to announce that MasteryPaths is now available in all worldwide regions!

As always, if you encounter any contrary behaviors in your Canvas experience, please submit a ticket to the Canvas support team.

Thank you,