Table of Contents
Gradescope integrations with LMSs, such as Canvas, are available with an institutional Gradescope license. When you access Gradescope through Canvas, you and your students won't need to create or use a separate Gradescope password, because you will be authenticated via your Canvas credentials. If you already have a Gradescope account under the email address that's associated with your Canvas account (e.g., your school email), when you access Gradescope in Canvas you will be taken to your existing account.
Below is the general process you should follow to be able to use Gradescope in Canvas. 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. Create and link your assignment.
- Step 4. Grade submissions.
- Step 5. Post grades.
Linking your courses
- Log in to Canvas. Click the existing published course you'd like to link to Gradescope or create a new one.To create a new Canvas course: From your Canvas Dashboard, click Start a New Course (right sidebar) > Name the course > Click Create Course > Click Publish > Choose a homepage > Click Choose and Publish. If that doesn't work, contact your Canvas administrator.
- In the left sidebar of your course page, click Gradescope. This will launch Gradescope in Canvas or in a new tab, depending on your settings.If Gradescope isn't listed: Click Settings > Click Navigation > Drag Gradescope into the visible items list > Click Save. If that doesn't work, contact your Canvas administrator.
- Once Gradescope launches, 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 Course Settings page.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 Canvas.
Existing Gradescope users: If you already have a Gradescope account under the email address that's associated with your Canvas account (e.g., your school email), a new Gradescope account will not be created for you, and clicking the Gradescope link in Canvas will take you to your existing account.
- On the 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 Canvas.
- When you're finished, click Update Course. Your course is now linked and your students can access this Gradescope course. Now, it's recommended that you sync your roster and link your assignment.
Syncing your roster
- 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 Canvas, click your course, and then click Gradescope in the left sidebar.
- On your Gradescope Course Dashboard, next click Roster in the left sidebar to get to your Roster page. On your Roster page in Gradescope, click the Sync Canvas Roster button in the footer or the middle of your page.Terminology differences: If your institution is using the latest version of the Gradescope tool (LTI 1.3), your roster sync button may display a customized name your institution has chosen instead of the word "Canvas."
- Once you click the button, a dialog box will appear explaining how accounts will be synced. All names, emails, and student IDs will be auto-synced from Canvas. All user roles will be synced depending on how your institution initially configured your Gradescope integration.ID and section name syncing: If your institution uses the older version of the Gradescope tool (LTI 1.0+API), your IDs and section names will be auto-synced also. The latest version of the Gradescope tool (LTI 1.3) can auto-sync your IDs, but cannot auto-sync section names yet. That capability is coming soon. In the meantime, you can manually add IDs and section columns to your roster if needed.
- 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.
- Click Sync Roster. If students add/drop in Canvas, 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 problems while syncing your roster, see the Troubleshooting section at the end of this page or contact firstname.lastname@example.org.To add or change section names: After syncing, click Download Roster (bottom of Gradescope Roster page) > Add or update section values on the CSV file > Click Add Students or Staff > Upload the CSV back to Gradescope. Canvas linking and any existing submissions and grades will be preserved as long as emails stay the same. Please note that if you are using LTI 1.0 + API and re-sync your roster, you will lose any customized section names you added.
Creating and linking your assignments
- Open your linked course in Canvas. Click Assignments in the left sidebar and then click the +Assignment button.
- Enter your assignment name and overall point value. Skip down to Submission Type and select External Tool from the dropdown. Next, click the Find button and select Gradescope from the list of external tools.
- If your institution is using the latest version of the Gradescope tool (LTI 1.3), the next thing you'll see is a dialog box about linking to a Gradescope assignment. If you don't see that after you select Gradescope from the list of external tools, your institution is using the older version (LTI 1.0+API). Click the appropriate tab below to see the next set of instructions based on your version.To enlarge/restart the gif: Right-click on it. Then select Open Image in New Tab.
To enlarge/restart the gif: Right-click on it. Then select Open Image in New Tab.
- Once you've found the Gradescope tool, click Select. Beneath the External Tool URL bar, it's recommended that you also select "Load this Tool in a New Tab." Click Save and Publish. This will either open your Gradescope Course Dashboard in a new tab or in an embedded window in Canvas depending on your settings.
- On your Gradescope Course Dashboard, click an existing Gradescope assignment or click Create Assignment to make a new one.
- If you're creating a new Gradescope assignment, next choose the assignment type and settings. See our Help Center article on creating an assignment for details on assignments and settings. As you're creating the assignment, make sure the point value you give the Gradescope side of the assignment matches the point value you gave the assignment on the Canvas side. When you've chosen your settings, click Create Assignment.
- Next, expand the left sidebar in your Gradescope window and click Settings. Scroll down to the Canvas Assignment section and click Link. When the dialog box appears, select your Canvas assignment from the dropdown. Your assignment is now linked. When students click on the assignment name in Canvas, they’ll be taken to that assignment in Gradescope. To see what your students will see, check out the article on Using Gradescope with Canvas as a Student.
- In the dialog box, choose to link to a new or existing Gradescope assignment (if you have any). Then click Link Assignment.
- If you're creating a new Gradescope 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.
- Next, you will be taken you back to the External Tool dialog box in Canvas. Make sure the Gradescope tool is still highlighted, then click the Select button. This will take you back to Submission Type section of the Create Assignment page in Canvas. In the Submission Type section, it's recommended that you select "Load this Tool in a New Tab." Double-check that the Gradescope tool URL is now shown in the URL bar. Scroll down to the end of the page in Canvas, click Save and Publish. Your assignment is now linked and students will be taken to that assignment in Gradescope when they click the link in Canvas.
- After saving, you'll be taken back into your Gradescope assignment where you can add in your questions or complete your assignment outline. Click Save when you're finished. To see what your students will see at this point, check out the article on Using Gradescope with Canvas as a Student.
- Launch your Gradescope assignment. To do that, log in to Canvas, navigate to your course, click Gradescope in the left sidebar, and then click your assignment. Alternatively, if you created a direct link to this Gradescope assignment, you can click that on your Assignment's page in Canvas.
- Once the Gradescope assignment launches, click Grade Submissions in the left sidebar of Gradescope to start grading.
- Once you do that, the process for grading is the same for Canvas and non-Canvas Gradescope users, so check out the detailed article on Grading Submissions. Once you've finished grading, see the next section for posting grades so students can see how they did.
- Make sure you've synced your roster.
- Then when you've finished grading submissions, you will be taken to the Gradescope Grading Dashboard for the assignment. Expand the left sidebar in Gradescope (if it isn't already) and click Review Grades. Then, on the Review Grades page, click the Post Grades to Canvas button.Terminology differences: If you're using the latest version of the Gradescope tool (LTI 1.3), your post grades button may display a customized name your institution has chosen instead of the word "Canvas."
- A dialog box will appear explaining how grades will be pushed from Gradescope to Canvas. In the dialog box, click Post Grades. Only the overall score for each fully graded assignment will be posted to your Canvas Gradebook. Fully graded assignments will have a checkmark next to them on the Review Grades page in Gradescope. If you have issues posting grades to Canvas, see the Troubleshooting section at the end of this page or contact email@example.com.Ungraded or partially graded submissions: When you post grades to Canvas with the older version of the Gradescope tool (LTI 1.0+API), a dash appears next to any remaining ungraded or partially graded submissions. The latest version of the Gradescope tool (LTI 1.3) displays a dash next to ungraded submissions and an alert icon next to any partially graded submissions.
- 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 article on Using Gradescope with Canvas as a Student.
I can't sync the roster at all.
Especially if you are a teaching assistant (TA), it's possible that the permissions for your role in Canvas currently do not allow you to access student email addresses, which you will need to sync a roster. If you suspect this may be the case, most likely, you will need to ask another instructor or an admin in your course to make some account and/or permission changes. Here's what to ask them:
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 Canvas. To fix the issue, either ask the course members or your Canvas admin to add the email addresses to the accounts in Canvas. Then re-sync the roster.
After I unlink a Canvas course from Gradescope, the initially synced roster will remain on the Roster page even after I link a new course.
Please contact firstname.lastname@example.org 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.
I can't post grades from Gradescope to Canvas.
Embedded window issues
Gradescope doesn’t appear in the embedded window when I use the Safari browser
To use Gradescope in an embedded window within Canvas, select Preferences from Safari’s settings and then ensure Prevent cross-site tracking is unchecked.
Gradescope doesn’t appear in the embedded window when I use Chrome in incognito mode
Third-party cookies may be blocked which will prevent this functionality.
To temporarily enable third party cookies, select the eye icon on the right of the URL address bar when you attempt to launch Gradescope LTI. A modal will appear where you can select "Site not working?" and then Allow cookies. This setting will reset when you restart your browser.
To permanently allow third-party cookies, go to https://support.google.com/chrome/answer/95647. Select Privacy and security and then Cookies and other site data. Here you will be able to Allow all cookies. This setting will remain unless you return to the settings and disable it.