How to Use Gradescope LTI 1.3 to Connect Gradescope to bCourses

A knowledge base article about How to Use Gradescope LTI 1.3 to Connect Gradescope to bCourses provided by the UC Berkeley IT Service Hub - Knowledge Portal

Gradescope LTI 1.3 enables course and assignment linking, roster syncing, and grade passback to bCourses.

Table of Contents

Link a bCourses Course Site to a Gradescope Course

Linking a bCourses course site to a Gradescope course adds a Gradescope course navigation menu item to bCourses that links to your Gradescope course and enables roster syncing and assignment linking from bCourses.

  1. Click on "Settings" in the bCourses course navigation menu
  2. Click on the "Navigation" tab
  3. Enable "Gradescope" and then click "Save"

    A screenshot of the Settings section in a bCourses course site
  4. Click on the newly added "Gradescope" course navigation menu item to launch Gradescope in a new tab and initiate course linking between bCourses and Gradescope
    1. Linking bCourses and Gradescope must be initiated in bCourses.
  5. In the Gradescope dialogue box choose to create a new course or link to an existing course, then click "Link Course"

    A screenshot of the "Link to bCourses Course" Gradescope dialogue box

Sync Your bCourses Roster

  1. Open your linked Gradescope course
    1. Use the "Gradescope" course navigation menu item in bCourses or go directly to Gradescope
  2. Go to the section "Roster"
  3. Click the button "Sync bCourses Roster" (this option may be located under the "More" menu)
    1. Remember that changes to the roster do not update automatically from bCourses. Re-sync the roster to apply any roster changes to Gradescope.
  4. In the dialogue box "Sync with bCourses Roster" click the button "Sync Roster"

Add a Gradescope Assignment to bCourses or Link an Existing Assignment

  1. (Option 1) To create a new assignment: In the "Assignments" section in bCourses click "+ Assignment"
        (Option 2) To link an existing bCourses assignment: Open the bCourses assignment and click "Edit"
  2. In the section for "Submission Type" choose "External Tool" from the drop-down menu
  3. Under "Enter or Find an External Tool URL" click "Find"

    A screenshot of the "Submission Type" section in the settings of a bCourses assignment
  4. Click on "Gradescope" in the list of tools and a Gradescope dialogue box will appear
  5. Choose the assignment to link to from the list of Gradescope assignments (or create a new assignment) and click "Link Assignment"
    1. Once a Gradescope assignment is linked to bCourses the name of the Gradescope assignment and the assignment due date will sync from bCourses
    2. Don't see this dialogue box? It may be blocked by your browser. Find troubleshooting tips below.

      A screenshot of the dialogue box "Link Resource from External Tool" in bCourses assignment settings

  6. Once linked, click "Select" in the bCourses dialogue box to save the change

    A screenshot of the dialogue box "Configure External Tool" in the bCourses assignment settings

  7. (Recommended, but optional) After clicking "Select" enable the option to "Load This Tool In A New Tab"

    A screenshot highlighting "Load this tool in a new tab" in the bCourses assignment settings
  8. Click "Save and Publish" (or "Save" if the assignment is already published) to save your changes and publish the assignment in bCourses
  9. IMPORTANT! To finalize the connection launch the Gradescope assignment from bCourses at least once
    1. This will allow the assignment grades to be synced from Gradescope to bCourses

      A screenshot of a bCourses assignment showing the button to load the assignment in a new tab

Sync Grades to bCourses

  1. Open a Gradescope assignment
  2. Go to the section "Review Grades"
  3. Click on the button "Post Grades to bCourses"
  4. In the dialogue box "Post Grades to bCourses" click the button "Post Grades"
    1. You can close the dialogue box once grades have successfully been posted
    2. Don't see the "Post Grades to bCourses" button? Find troubleshooting tips below.

Troubleshooting Gradescope LTI 1.3 Issues

I can't link my bCourses course site to Gradescope

If you get an error message that says "Course hasn't been created. Reach out to your instructor or email help@gradescope.com" then you don't have the right permissions in bCourses to link a Gradescope course. You must have the Teacher, Lead TA, TA, Reader, or Designer role in the bCourses course site to link the course to Gradescope.

I can't link a bCourses assignment to Gradescope

Linking an assignment to Gradescope requires your browser to allow Gradescope to open an embedded window in bCourses, which may be blocked by your browser settings or browser extensions.

Safari

  1. Open Settings and go to the "Privacy" section
  2. Disable "Prevent cross-site tracking"

Chrome

  1. Open Settings and go to the "Privacy and Security" section
  2. Click on "Third Party Cookies"
  3. Select "Allow third party cookies"

Other Troubleshooting Steps

  1. Clear your browser cache and cookies
  2. Make sure your browser is updated to the latest version
  3. Try an incognito or private browsing window
  4. Try a different browser
  5. Try a different device

The "Post Grades to Canvas" button isn't working

The "Post Grades to Canvas" button in Gradescope has been deprecated as part of Gradescope LTI 1.0. With LTI 1.3 you should always use the "Post Grades to bCourses" button in Gradescope to sync grades from Gradescope to bCourses.

The "Post Grades to bCourses" button isn't showing up

First, make sure that the assignment in bCourses is linked using LTI 1.3. In bCourses, the External Tool URL for Gradescope LTI 1.3 is

https://lti.int.turnitin.com/launch/gs-proxy

Edit the assignment settings in bCourses and verify the External Tool URL is correct. If not, the assignment is linked incorrectly or linked using (deprecated) LTI 1.0. Re-link the bCourses assignment to Gradescope using LTI 1.3.

If the assignment is correctly linked to Gradescope, try launching the assignment from bCourses at least once. This finalizes the connection and enables grade passback to bCourses. The "Post Grades to bCourses" button will not be available until the connection has been finalized.

A student in the Gradescope roster doesn't seem to be linked to bCourses

Try re-syncing the roster in Gradescope.

Help Resources

Email support: gradescope@berkeley.edu

Schedule a consultation: calendly.com/research-teaching-and-learning/gradescope

Vendor documentation: Using Gradescope LTI 1.3 with Canvas as an Instructor