Table of Contents
Gradescope integrations with Learning Management Systems (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'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 Canvas 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 Canvas, 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.
Once you decide how you want to access Gradescope, below is the general process you should follow to be able to use Gradescope with Canvas. In this guide, you'll find specific details for completing each of these steps and links to other pertinent Gradescope Help Center articles. Also, if you plan to access your Gradescope account starting on the Gradescope website rather than Canvas, look for the Alternate method notes on this page to help you with certain tasks.
- 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 Canvas and Gradescope 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: Click Courses > Click Start a New Course > 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 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 Canvas 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 Canvas 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
- Log in to Canvas or gradescope.com. Then click your course.
- If you started in Gradescope, next click Roster in the left sidebar to get to your Roster page. If you started in Canvas, click Gradescope in the left sidebar. This will launch Gradescope. Then expand your left sidebar in Gradescope (if it isn't already) and click Roster to get to your Roster page.
- On your Roster page in Gradescope, click the Sync Canvas Roster button. A dialog box will appear explaining how accounts will be synced. All names, emails, IDs, and section names will be auto-synced from Canvas. All user roles will be synced depending on how your institution initially configured your Gradescope integration.
- 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 roster-syncing issues, contact firstname.lastname@example.org.To change section names: After syncing, click Download Roster (bottom of Gradescope Roster page) > 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 re-sync your roster, you will lose any customized section names you added.
Creating a Gradescope assignment and linking it to Canvas
- Open your linked course in Canvas. 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. Click Select. Beneath the External Tool URL bar, it's recommended that you also select "Load this Tool in a New Tab." Click Save & Publish. This will either open your Gradescope Course Dashboard in a new tab or in an embedded window in Canvas depending on what you selected for "Load this Tool in a New Tab."
- 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 assignment, next choose the assignment type and settings. See our Help Center article on creating an assignment for details on assignments and settings. Make sure the point value you give the assignment matches the point value you gave the assignment on the Canvas side. When you've chosen your settings, click Create Assignment.
- Then 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.
- Log in to Canvas or gradescope.com and navigate to your linked course. If you started in Gradescope, next click the assignment and Grade Submissions in the left sidebar to start grading. If you started in Canvas, click Gradescope in the left sidebar. This will launch Gradescope. Then click the assignment and Grade Submissions in the left sidebar 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 your linked assignment (see the section above), 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.
- On the Review Grades page, click the Post Grades to Canvas button. A dialog box will appear explaining how grades will be pushed from Gradescope to Canvas. In the dialog box, click Post Grades. Posting Grades to Canvas will only post the students' final assignment scores to the Canvas assignment. Only grades for fully graded submissions (which have a checkmark in the Graded column on the Review Grades page) will be posted.If grades aren't posting: Re-sync the roster > Click Post Grades to Canvas again. If that doesn't work, email email@example.com.
- 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