What’s new?

Those who use Gradescope with Sakai should now connect directly to Gradescope within Sakai, rather than going to or sending students to http://gradescope.com outside of Sakai. Integrating Gradescope into Sakai allows consistency in logins and grade transfers between the two systems. You and your students won’t need to create or use a separate Gradescope login and password, because you will be authenticated via your Sakai credentials (netID). Important: Students who have used Gradescope in the past by going directly to the Gradescope website will need to be re-oriented to accessing Gradescope via the menu button in Sakai.

Getting started

As mentioned, we recommend that you and your students access Gradescope through Sakai, rather than accessing Gradescope directly at gradescope.com. Once you have set up the Gradescope integration in Sakai (instructions below), please clearly explain to students that they MUST access Gradescope through the Sakai menu button to avoid issues with roster and grade transfers between the two systems.

If you already have a Gradescope account under the email address that’s associated with your Sakai account, when you access Gradescope in Sakai you will be taken to your existing account. If you don’t yet have a Gradescope account under the email address you use to access Sakai, one will be created when you login. If you do end up with multiple accounts under multiple emails, you can merge accounts.

Below is the general process you should follow to be able to use Gradescope in Sakai. 

  1. Link your Sakai course site to the corresponding Gradescope course.
  2. Sync your roster from Sakai to Gradescope.
  3. Set up your Gradescope assignments.
  4. Grade submissions.
  5. Post grades to Sakai.

Linking your courses

Linking one Sakai course to multiple Gradescope courses: If you have several courses on Gradescope that correspond to a single Sakai course, Gradescope does not recommend that you link your Sakai course to Gradescope. Linking courses, in this case, would allow students to enroll in any of the Gradescope courses that are associated with the single Sakai course.

  1. In Sakai, navigate to the course site where you will be using Gradescope.
  2. Click Gradescope in the left side menu. This will launch Gradescope in Sakai.

If Gradescope isn’t in the side menu yet: Click Site Info > Click Manage Tools > Scroll down and expand the External Tools dropdown > Select Gradescope > Click Continue > Click Finish. Gradescope should now be listed in your left side menu.

  1. Once Gradescope launches within the Sakai window, you’ll see a dialog box with course-linking options. Choose to link to a new or existing Gradescope course, and then click Link Course to go to the Gradescope Course Settings page.
    Link to Sakai course

New Gradescope users: At this point, a new Gradescope account will be created for you if you do not already have one associated with the email address (e.g., your school email) that you use in Sakai.

Existing Gradescope users: If you already have a Gradescope account under the email address that’s associated with your Sakai account (e.g., your school email), clicking the Gradescope link in Sakai will take you to your existing account.

  1. On the Gradescope Course Settings page, you can update the Gradescope course title, description, rubric types, and score bounds. Keep in mind that course title and description changes made here will only appear in Gradescope, not in Sakai. 
  2. When you’re finished, click Update Course. Your Sakai and Gradescope courses are now linked. Now, sync your roster.

Changing how Gradescope launches in Sakai (embedded or in a new tab): The default function of the Gradescope tool in Duke Sakai is to launch as an embedded window in Sakai. If you prefer you and your students see Sakai in a new tab, you can adjust the settings. 

In your Sakai course, click Gradescope in the left sidebar > Gradescope will launch in an embedded window in Sakai  > Click Edit or the pencil icon above the embedded window or back on your open Sakai tab > Select Launch in popup > Click Update Options. Gradescope will now open in a new tab when you or your students access it in Sakai. You can change that back if you wish. If you could not update your launch settings, contact your Sakai administrator.

Syncing your roster

  1. Navigate to your Gradescope Course Dashboard in Sakai. If you’re continuing from the steps in the section above, you will already be there. If not, click the Gradescope link in the side menu of your Sakai course site.
  2. On your Gradescope Course Dashboard, click Roster in Gradescope’s left sidebar to take you to the Roster page. If the tool window is embedded in Sakai, you may need to expand Gradescope’s left sidebar first. On the Gradescope Roster page, click the Sync Sakai Roster button at the bottom of your screen.
  3. A dialog box will appear explaining how accounts will be synced. All names, emails and student IDs will be auto-synced from Sakai. All user roles will be synced. Existing Sakai group names/numbers (including sections) will be synced as well, but Gradescope will call them “sections.” Only one section (Sakai group number/name) per person will be displayed on your roster, but you can add or change groups/sections after you sync your roster (see note below).

Troubleshooting: If you encounter any issues while trying to sync your Sakai roster with Gradescope, please see our troubleshooting section on roster-syncing issues at the end of this page. If the solutions there don’t work, please contact help@gradescope.com.

Sync with Sakai roster
  1. To see what groups a student belongs to in Gradescope, go to the Gradescope course dashboard, click Roster, hover over a student name, click “Edit student” and group names will be displayed in the student information pop-up.
  2. By default, Gradescope will email users to say that they’ve been added to the course. If you don’t want users to be notified, uncheck “Let new users know that they were added to the course” in the dialog box.
  3. Click Sync Roster. Sakai may alert you that Gradescope is trying to access your information. If you see this alert, log in (if prompted), click Continue, and then click the Sync Roster button again. If students add/drop in Sakai, be sure to re-sync the roster. Existing submissions/grades for dropped students will be preserved. See the Adding Students and Staff article for more tips.

To change or add group names in Gradescope: After syncing, click Download Roster (bottom of Gradescope Roster page) > Add a new column of group values or update existing group values in the downloaded CSV file and save the file > in Gradescope click Add Students or Staff+ > Upload the CSV back to Gradescope. Sakai linking and any existing submissions and grades will be preserved as long as emails stay the same. Please note that if you re-sync your roster, you will lose any group names you previously added or changed.

Setting up your Gradescope assignments

  1. Navigate to your Course Dashboard in Gradescope. To do that, go to your course site in Sakai, and then click Gradescope in the left sidebar.
  2. On your Gradescope Course Dashboard, click an existing Gradescope assignment or click Create Assignment to make a new one.
  3. If you’re updating an existing assignment, click Settings in the left sidebar, make your changes, and then click Save. If you’re creating a new assignment, next choose the assignment type and settings. See our Help Center article on creating an assignment for details on assignments and settings. When you’ve chosen your settings, click Create Assignment.
  4. Your assignment is now updated/created. For student-uploaded assignments, once your release date passes in Gradescope, students will be able to submit work when they access Gradescope via the link in their left sidebar in Sakai.

Do I need to connect my Gradescope assignment back to Sakai? Yes, but not until you’re ready to post Gradescope grades to your Sakai Gradebook page. See Steps 1-3 of Posting grades if you’d like to do this now.

Grading submissions

  1. Launch the Gradescope assignment you’d like to grade. To do that, log in to Sakai, click your course, and then click Gradescope in the left side menu. Once Gradescope launches, click your assignment.
  2. When your assignment is open, expand Gradescope’s left side menu (if it isn’t already), and click Grade Submissions to start grading.
  3. Once you do that, the process for grading is the same; see the detailed article on Grading Submissions.

    Gradescope grading interface

Posting grades

Troubleshooting: If you encounter any issues while trying to post grades from Gradescope to Sakai, please see our troubleshooting section on grade-posting issues at the end of this article. If the solutions there don’t work or the problem you’re trying to solve isn’t listed, please contact help@gradescope.com.

  1. First, make sure you’ve already synced your roster. Next, make sure you see Gradebook listed in the left side menu of your Sakai course. If you don’t see Gradebook in the sidebar, click Site Info > click Manage Tools > Select Gradebook.



    Note: To enlarge/restart the gif: Right-click on it. Then select Open Image in New Tab.
  2. Create a Sakai gradebook item from Gradescope. To do that, launch your Gradescope Course Dashboard by clicking the Gradescope link in the left sidebar of your Sakai course.
  3. Once Gradescope launches, click the Gradescope assignment you’d like to link to Sakai, expand Gradescope’s left sidebar (if it isn’t already), and click Settings.
  4. Scroll down to the Sakai Gradebook Item section and click Link. When the dialog box appears, click Create New Gradebook Item or select the name of an existing Sakai gradebook item from the dropdown. Only Sakai gradebook items that you created from Gradescope will appear in the list. Scroll down and click Save when you’re finished.
  5. With your assignment open, expand Gradescope’s left sidebar (if it isn’t already) and click Review Grades. On the Review Grades page in Gradescope, click the Post Grades to Sakai button. When the dialog box appears, click Post Grades. Posting grades to Sakai will only post the students’ final assignment scores from Gradescope to the linked gradebook item in Sakai. Only grades for fully graded submissions (which have a highlighted, teal checkmark in the Graded column on the Review Grades page) will be posted.
  6. Next, if you want students to also see their graded, annotated submissions, question-by-question scores, rubrics, and feedback on Gradescope, click the Publish Grades button. If you’d like to, click the Compose Email to Students button at the bottom of the Review Grades page in Gradescope to alert students via email that their grades are now visible. To see what your students will see when they view their grades, check out the Using Gradescope with Sakai as a Student article.

Troubleshooting

Roster-syncing issues

IssueSolutions
I’m a TA and I don’t see the sync roster button.Only Gradescope instructors can sync with the Sakai roster.

Solution 1: Have an instructor in the Gradescope course update your Gradescope role to instructor.

Solution 2: Have your Sakai admin contact help@gradescope.com and request that Sakai TAs are synced into Gradescope as an instructor.
I’m a TA and I can’t sync the roster at all.Contact an instructor in your course. Ask them to add the “View participant’s email” permission to your role on the course’s Roster page in Sakai. You can direct them to the steps in the row below if they don’t know how to do that.
I’m an instructor. I can’t sync the roster and/or my colleague can’t sync the roster at all.Solution 1: Navigate to your roster page on your course site in Sakai (if you don’t see the Roster tool, add it using Site Info > Manage Tools). Click the Permissions tab. When the role permissions table appears, locate the column for the role that needs to be given different permissions. In the column, select the “View participant’s email” box. Click Save. Wait a few minutes for Sakai to process the update. Then confirm that emails are now available. Check for yourself (if you were updating your role) or direct your colleague (if you were updating their role) to click the Overview tab on the Roster page. An “Emails” column with course members’ email addresses should appear. Once the “Emails” column appears, roster syncing should be available in Gradescope.

Solution 2: Contact an admin. Ask them to go to their Admin Site Perms page in Sakai and add the “roster.viewemail” permission to your role or the role that needs to be updated. You can direct them to the following article from Sakai if they don’t know how to do that: How do I add role permissions for all sites?
As an instructor or TA, I can only sync part of my roster.If some members of your course can’t be synced along with the rest of your roster, most likely, these members do not have an email address associated with their account in Sakai. To fix the issue, either ask the course members or your Sakai admin to add the email addresses to the accounts in Sakai. Then re-sync the roster.
After I unlink a Sakai course from Gradescope, the initially synced roster will remain on the Roster page even after I link a new course.Please contact help@gradescope.com to have the excess students removed. Alternatively, if there are no assignments within the course, you can delete it and create a new one to link with Gradescope.

Grade-posting issues

IssueSolution
I am a TA and can’t post grades from Gradescope to Sakai.Ask an instructor in your course to change your role to “instructor” on the Gradescope course roster page. If that doesn’t work, try the steps listed in the section about Roster-syncing issues. Grade-posting and roster-syncing problems are often related.
I am an instructor and can’t post grades from Gradescope to Sakai.Re-sync the roster in Gradescope. Then click Post Grades again.
In my Sakai gradebook, I can’t edit grades that I posted from Gradescope.To post Gradescope grades to Sakai, you have to create a Sakai gradebook item from Gradescope, and it is not possible to directly edit one of these gradebook columns in Sakai. If you need to edit Gradescope grades in a locked Sakai gradebook column, try the workarounds below.

Solution 1: In Gradescope, go to the Grade Submissions page for the assignment. Update students’ scores on the relevant questions. Then go to the Review Grades page in Gradescope and repost the assignment grades to the same Sakai gradebook item. This will update the assignment grades in Sakai.

Solution 2: In Gradescope, download a CSV of assignment grades from the Review Grades page. In that CSV file, edit students’ grades as needed, and format the CSV file according to Sakai’s guidelines (see the Import / Export tab of your Sakai Gradebook page). Then in Sakai, remove the incorrect gradebook column from course calculations and hide the column. Then create a new gradebook column in Sakai and manually upload the CSV to that gradebook column.
I posted grades from Gradescope to Sakai. In my Sakai gradebook, I can’t give zeros to students who didn’t submit this assignment.To post Gradescope grades to Sakai, you have to create a Sakai gradebook item from Gradescope. When you post grades to a Sakai gradebook item that you created from Gradescope, students who did not submit work will have no grade listed and the gradebook column you created in Gradescope will be locked (not editable) in Sakai. If you need to give zeros in a locked Sakai gradebook column, try the workarounds below.

Solution 1: In Gradescope, upload a blank submission for each student who didn’t submit the assignment and give each of those submissions a zero on every question. This will ensure that students without submissions receive an overall zero for the assignment in Gradescope. Then repost the Gradescope grades to your Sakai gradebook item.

Solution 2: In Gradescope, download a CSV of assignment grades from the Review Grades page. In that CSV file, change scores to zero for students with no submissions, and format the CSV file according to Sakai’s guidelines (see the Import / Export tab of your Sakai Gradebook page). Then in Sakai, remove the incorrect gradebook column from course calculations and hide the column. Then create a new gradebook column in Sakai and manually upload the CSV to that gradebook column.

Solution 3: In Sakai, go to the Grades tab of your Gradebook page. Then use the set zero score for empty cells feature in the Course Grade column to enter a zero for students who have no scores synced from Gradescope. Please keep in mind though that this feature will also enter a zero in all empty cells in all gradebook columns in this course.
In my Sakai gradebook, I can’t delete a column containing grades that I posted from Gradescope.To post Gradescope grades to Sakai, you have to create a Sakai gradebook item from Gradescope, but there is no way to delete Sakai gradebook items that were created from Gradescope. However, you can hide an unwanted gradebook item column and not include it in the course grade total. Follow the steps below to learn how.

1. Go to your course’s Gradebook page in Sakai. Make sure you’re on the Grades tab. Then find the unwanted gradebook column.

2. Click the down arrow under the column header and select “Edit Item Details.” When the Edit Gradebook Item dialog box appears, deselect “Include items in course grade calculations?” Click Save Changes.

3. Click the down arrow under the column header again, and now select “Hide Item” from the dropdown.
I can’t post scores that are greater than the max. point value from Gradescope to Sakai (i.e. 12/10 points).Unfortunately, our current version of Sakai does not allow you to post a score from Gradescope to Sakai that exceeds the max point value. Any grade you post that does exceed the max point value will be reset to the max point value. There are a couple of workarounds through.

Solution 1: In Gradescope, download a CSV of the assignment grades from the Review Grades page. In that CSV file, edit students’ grades as needed, and format the CSV file according to Sakai’s guidelines (see the Import / Export tab of your Sakai Gradebook page). Next, in Sakai, remove the incorrect gradebook column from the course calculations and hide the column. Then create a new gradebook column in Sakai and manually upload the CSV to that gradebook column.

Solution 2: Post grades from Gradescope to Sakai. Then try to edit grades individually once they’re in Sakai. Please keep in mind that for some LTI and Sakai versions this solution will not be possible. If this solution doesn’t work for you, try Solution 1 above.