Table of Contents

Using Gradescope with Sakai as an Instructor

Updated

Getting started

Gradescope integrations with LMSs, such as Sakai, are available with an institutional Gradescope license. When you access Gradescope through Sakai, you and your students won't need to create or use a separate Gradescope password, because you will be authenticated via your Sakai credentials.

If you'd like to access your Gradescope account on the Gradescope website, you and students can go to gradescope.com and log in with your school credentials if your institution has that option. If you don't have that option, you can access the Gradescope website by clicking Sign Up on the Gradescope homepage and entering the email address associated with your Sakai account, or by logging in to your existing Gradescope account via the Log In button. Regardless of whether you access Gradescope on the website or via Sakai, you will be taken to the same Gradescope account, as long as the email address linked to the account is the same. If you or your students do end up with multiple accounts under multiple emails, you or they can merge accounts.

Below is the general process you should follow to be able to use Gradescope with Sakai. In this guide, you'll find specific details for completing each of these steps and links to other pertinent Gradescope Help Center articles.

  • Step 1. Link your courses.
  • Step 2. Sync your roster.
  • Step 3. Set up your assignment.
  • Step 4. Grade submissions.
  • Step 5. Post grades.
 

Linking your Sakai and Gradescope courses

Alternate method: This section shows how to link your Gradescope and Sakai courses starting on Sakai. If you'd rather link starting on gradescope.com, you still must have a course set up in Sakai already. A Sakai administrator may need to create the course for you. After that, log in to gradescope.comcreate a new Gradescope course or open an existing one, and link it back to Sakai from the Gradescope Course Settings page.
  1. Log in to Sakai. Click on the Sakai course you'd like to link to Gradescope (Click Sites > Type course name in Filter Sites search bar > Click the course name).
  2. Click Gradescope in the left sidebar. This will launch Gradescope in Sakai or in a new tab, depending on your settings or your institution's settings (see the note at the end of this section).
    If Gradescope isn't listed: Click Site Info > Click Manage Tools > Scroll down and expand the External Tools dropdown > Select Gradescope (or the name of the Gradescope tool at your institution) > Click Continue < Click Finish. Gradescope should now be listed in your left sidebar. If this didn't work, contact your Sakai administrator.
  3. Once Gradescope launches, you'll see a dialog box with the option to create and link to a new Gradescope course or link to an existing Gradescope course you may have. Choose new or existing, and then click Link Course to go to the Course Settings page. If this is your first Gradescope login with these Sakai credentials, a new Gradescope account will be created for you. The username for your Gradescope account is the same email address that's associated with your Sakai account.
    Sakai instructor linking Sakai and Gradescope courses
  4. On the Gradescope Course Settings page, you can update the 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. When you're finished, click Update Course. Your Sakai and Gradescope courses are now linked. Now, it's recommended that you sync your roster.
    Embedding or launching Gradescope in a new tab: In your Sakai course, click Gradescope in the left sidebar > Gradescope will launch as an embedded window in Sakai or in a new tab > Click Edit above the embedded window or back on your open Sakai tab > Select or deselect Launch in popup > Click Update Options. Depending on your selection, Gradescope will now open as an embedded window or in a new tab when you or your students access it in Sakai. If you could not update your launch settings, contact your Sakai administrator.
 

Syncing your roster

  1. Navigate to your Gradescope Course Dashboard. If you're continuing from the steps in the section above, you will already be there. If not, log in to Sakai, click your course, and then click Gradescope in your left sidebar, or log in to gradescope.com and click your course. Both methods will take you to your Gradescope Course Dashboard.
  2. On your Gradescope Course Dashboard, click Roster in the left sidebar to get to your Gradescope Roster page. Then click the Sync Sakai Roster button. A dialog box will appear explaining how accounts will be synced. All names, emails, and IDs will be auto-synced from Sakai. All user roles will be synced depending on how your institution initially configured your Gradescope integration. Please note that Gradescope only carries over one Sakai group number/name per person on your roster, but you can add or change groups after you sync your roster. See the note at the end of this section.
    Sakai instructor syncing their roster
  3. 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.
  4. 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. If you have any roster-syncing issues, contact help@gradescope.com.
    To change or add group names: After syncing, click Download Roster (bottom of Gradescope Roster page) > Add a new column of group values or update existing group values on the CSV file > 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 assignment

  1. Navigate to your Gradescope Course Dashboard. If you're continuing from the steps in the section above, you will already be there. If not, log in to Sakai, click your course, and then click Gradescope in your left sidebar, or log in to gradescope.com and click your course. Both methods will take you to your Gradescope Course Dashboard.
  2. On your Gradescope Course Dashboard, click an existing Gradescope assignment or click Create Assignment to make a new one. 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.
  3. 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 gradescope.com or the Gradescope link in the left sidebar of their Sakai course. To see what your students will see if they will be submitting work check out the Using Gradescope with Sakai as a Student article.
    Do I need to connect my Gradescope assignment to Sakai? Yes, but not until you're ready to post Gradescope grades to your Sakai Gradebook page. At that time you will need to connect your Gradescope assignment to a Sakai gradebook item that you created from Gradescope. See Steps 1-3 of Posting grades if you'd like to do this now.
 

Grading submissions

  1. Navigate to your Gradescope Course Dashboard. To do that, log in to Sakai, click your course, and then click Gradescope in your left sidebar, or log in to gradescope.com and click your course. Both methods will work.
  2. On your Gradescope Course Dashboard, click the assignment and Grade Submissions in the left sidebar to start grading.
  3. Once you do that, the process for grading is the same for Sakai and non-Sakai Gradescope users, so check out the detailed article on Grading Submissions. Once you've finished grading, be sure to connect your Gradescope assignment to a Sakai gradebook item so you can post grades to Sakai (see the next section).
    Sakai instructor grading a Gradescope submission
 

Posting grades

Troubleshooting: If you encounter any issues while trying to post grades from Gradescope to Sakai, please see our Troubleshooting section 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. Navigate to your Gradescope Course Dashboard. To do that, log in to Sakai, click your course, and then click Gradescope in your left sidebar, or log in to gradescope.com and click your course. Both methods will take you to your Gradescope Course Dashboard. Then double-check that you've already synced your roster on the Gradescope course roster page.
  2. To post Gradescope grades to Sakai, you need to either create a new Sakai gradebook item from Gradescope or use an existing Sakai gradebook item that was created from Gradescope. To create a gradebook item from Gradescope, first, click the Gradescope assignment you'd like to link to Sakai, expand the left sidebar (if it isn't already), and click Settings.
  3. 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.
  4. With your assignment open in Gradescope, expand the 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 checkmark in the Graded column on the Review Grades page) will be posted.
  5. 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

Problem

Solution

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.

I am an instructor and can't post grades from Gradescope to Sakai.

Re-sync the roster in Gradescope. Then click Post Grades to Sakai again.

I need to edit grades in a Sakai gradebook item I created from Gradescope.

In Sakai, it is not possible to directly edit gradebook columns that you created from Gradescope. If you need to edit grades in a locked gradebook column created from Gradescope, 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 (see the steps in the next row of this Troubleshooting table). Then create a new gradebook column in Sakai and manually upload the CSV to that gradebook column.

I need to give zeros to students without submissions in a Sakai gradebook item I created from Gradescope.

When you post grades from Gradescope 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 enter zeros in a Gradescope-created gradebook item in Sakai, 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 (see the steps in the next row of this Troubleshooting table). 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 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.

I need to delete a Sakai gradebook item I created from Gradescope.

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.

Was this article helpful?
Awesome, glad that it's helpful! 🙌 Have ideas on how we can improve? Sorry to hear that. Let us know what we can improve!
Need help?

Using Gradescope with Moodle as a Student

Using Gradescope with Sakai as a Student

Contact