Documentation:WeBWorK/How to set up Canvas grade sync

From UBC Wiki

In Canvas, it is possible to sync the grades of WeBWorK assignments with Canvas’s gradebook. This functionality is not automatic and requires the creation of individual assignment links in Canvas for each specific WeBWorK assignment rather than using a general WeBWorK link. To set up individual Canvas assignments for WeBWorK-Canvas grade sync, follow the instructions below.

How to create individual WeBWorK assignment links in Canvas

To create individual WeBWorK assignment links in your Canvas course:

  1. Create your assignment(s) in WeBWorK (click here for instructions on how to create an assignment).
  2. Log into Canvas.
  3. Click Assignments.
  4. Click +Assignment.
    Grade sync - 3,4.png
  5. Give the assignment link a name (i.e. WeBWorK Assignment01).
  6. In the Point field, enter the point value of the WeBWorK assignment.
  7. Select External Tool from the dropdown menu.
  8. Click Find. Note: You must click Find to properly set up the WeBWorK link in your course.
    Grade sync - 5,6,7,8.png
  9. From the list of External Tools, select WeBWorK, and click Select.
    Grade sync - 9.png
  10. In the URL field, append the following parameter at the end of the link to create a link to a specific WeBWorK assignment:
   ?set=assignment_name
  • The assignment_name is where you enter the specific name of the assignment you are creating a link for.
  • Note: This is the name of the assignment in WeBWorK, not the name of the assignment link that you created in Canvas.
  • For example, if your assignment is called HW1, then the URL should read.
   https://webwork.elearning.ubc.ca/webwork2/?set=HW1
  1. Check the box next to Load This In A New Tab.
    • Note: If you skip this step, WeBWorK will not sync the grades correctly with Canvas.

    Grade sync - 10,11.png

  2. Set a due date for the assignment link (recommended that the due date be the same as the WeBWorK assignment's closing date).
    • Note: the available from/until dates in Canvas only control the visibility of the assignment link in Canvas and do not control the availability of the WeBWorK assignment. In other words, setting the dates in Canvas does not automatically update the associated WeBWorK assignment.
  3. Click Save and Publish.

Grade sync - 12,13.png

Important information about Canvas grade sync

  • Grade sync: Grade sync between WeBWorK and Canvas occurs after a student’s submission. Additionally, an automatic grade sync occurs roughly every 8 hours and will capture the state of the WeBWorK grade at that time. If you would like the 8-hour automatic grade sync cycle to be turned off,  
    1. Go to the Course Configuration tab under Instructor Tools
    2. Click on the LTI tab
    3. Set “Automatically send student grades to LMS via cron job” to FALSE
    • Instructors can also manually sync grades between WeBWorK and Canvas:
    1. Go to the Hmwk Sets Editor
    2. Under the LTI tab, click Take Action!
  • Accessing the assignment: An assignment needs to be published in Canvas in order for students to be able to view and access the assignment. Furthermore, each student must access each WeBWorK assignment exclusively through Canvas in order for grades to sync properly between WeBWorK and Canvas.
  • Editing a student's WeBWorK assignment grade: To edit a student's grade, edit the grade in WeBWorK and not Canvas as WeBWorK’s grade sync will override the grade change in Canvas. See instructions for this here.
  • Auto-scaling point values: The grade sync between WeBWorK and Canvas auto-scales the grades, meaning that if a student received 2/3 in WeBWorK (66.6%), and the Canvas assignment was worth 2 points, the Canvas grade would be 1.33/2 (66.6%).
  • Canvas assignment due date vs WeBWorK assignment closing date: It is recommended that instructors use the same date for the Canvas assignment due date and the WeBWorK assignment closing date.