Getting Started
- Gradescope integrations with Canvas is available with an institutional Gradescope license.
- Has your institution changed to a Canvas LTI 1.3 integration? If your institution has recently moved from a Canvas LTI 1.0 integration to an LTI 1.3 integration, check out our Canvas LTI 1.3 Migration for Instructors guide. If you are unsure about this, please reach out to your Gradescope or Canvas administrator.
- 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.
Overview
Below is the general process you should follow to be able to use Gradescope in Canvas.
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
Linking one Canvas course to multiple Gradescope courses: If you have several courses on Gradescope that correspond to a single Canvas course, it is not recommended that you link your Canvas 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 Canvas course.
- 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.
Canvas administrators might opt to not configure the Gradescope link at the course level. If you don't see the Gradescope link in the left sidebar of your course or under Settings, you can skip to the Creating and linking your assignments section. You will be prompted to link your Canvas course to Gradescope when you go to link your first assignment.
- If Gradescope isn't listed: Click Settings > Click Navigation > Drag Gradescope into the visible items list > Click Save.
- 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, select 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.
Students are automatically added to the Gradescope roster once they select a Gradescope course or assignment link within Canvas.
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.
- 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 and sections 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 problems while syncing your roster, see the Troubleshooting article or contact help@gradescope.com.
- 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. If sections were synced from Canvas and you re-sync your roster, you will lose any customized section names that were manually added.
Creating and linking your assignments
The next steps show you how to create your Gradescope assignment and create a direct link to it in your Canvas course. If submissions will be student-uploaded, it's highly recommended that you link your Gradescope assignment to Canvas before releasing it to students so they can find it more easily in Canvas. If submissions will be instructor-uploaded, it's recommended that you only link your assignment when you're ready to publish grades.
- Access your course and then select Assignments from the course navigation menu.
- From the dotted drop-down menu in the top right corner, select the Gradescope link configured by your administrator. The Gradescope Create Assignment workflow will open within your Canvas environment. If you don’t see this option, please contact your administrator for further assistance.
- In the Gradescope Create Assignment modal, choose how you want to link this Canvas assignment to Gradescope: A new Gradescope Assignment or An existing Gradescope Assignment. Select Link Assignment.
- On the Create Assignment page, select the assignment type you want to create, and select Next. Customize any other settings your assignment type requires and then select Create Assignment. The Gradescope modal will close.
For more information on creating an assignment in Gradescope, check out our Assignment Settings Overview article.
- To finalize the assignment link and set up, select the assignment you just created in in the Assignments list on your Canvas Assignments dashboard and go back to Gradescope. You won't be able to post grades until you do this step. Note: Selecting on the assignment name will navigate you and your students to the linked Gradescope assignment.
- To edit the assignment settings in Canvas, select Edit Assignment Settings. You can edit:
-
- the assignment's total point value
- assignment release date
- due date
- late due date
- extensions
- any section-specific settings
The assignment release date, due date, late due date, extensions, and any section-specific settings don't sync between Canvas and Gradescope, so you will need to edit these settings in both Gradescope and Canvas.
-
- By default, the Gradescope assignment displays embedded within Canvas. If you want to change that, see the steps for Loading a Gradescope assignment in a new window.
-
To continue creating and customizing the assignment (like creating an outline) in the Gradescope workflow, select the Canvas assignment name to open it.
-
Save your changes.
-
Once the assignment is linked via LTI 1.3, the Gradescope assignment name is synced from the LMS and can only be edited in the Canvas, not in Gradescope. Once the Canvas assignment is successfully linked and published, students can select the Canvas assignment and submit to Gradescope from within their Canvas dashboard (for student-uploaded assignments only).
Loading a Gradescope assignment in a new window
When you or your students access and view a Gradescope assignment via Canvas, it displays embedded within your Canvas environment by default. This could limit the usable working space for grading an assignment, submitting an assignment, etc. To view the Gradescope assignment on a bigger screen (not embedded) for more working space, you can edit the assignment settings to have it open in a new window.
For Gradescope-linked assignments, we recommend only editing the assignment name, point value, and assignment description settings in Canvas. You should only edit Gradescope assignment settings in Gradescope.
- From the Assignments list on Canvas, select an assignment name to open it. Then select Edit Assignment Settings.
- Scroll down to the Submission Type section, and select the Load this Tool in A New Tab checkbox. You can edit this setting for how a Gradescope assignment displays at any time (embedded in Canvas or in a new window), even after students submit an assignment.
- Save and Publish your changes.
Now when you or your students open a Gradescope assignment link, the assignment page displays a Load assignment in a new Window button.
Publishing a Gradescope assignment in Canvas
To make Gradescope-linked assignment visible to students in their Canvas dashboard, you will need to publish the assignment in Canvas. This also allows students to use the assignment link to go to Gradescope and view their assignment submission status and grades.
- To publish the assignment in Canvas, select Assignments from the course navigation menu.
- On the Assignments page, locate the relevant assignment and select the Publish icon.
How does publishing affect assignments?
- For student-uploaded assignments on Gradescope, if the assignment is not published in Canvas and the Gradescope release date for the assignment passes, students can still view and submit the assignment on Gradescope.
- For instructor-uploaded assignments, we recommend waiting to publish a Gradescope-linked assignment on the Canvas side until after it's been fully graded and grades are published on the Gradescope side, otherwise students could receive an error message.
Grading submissions
- Launch your Gradescope assignment from your Canvas account:
- 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, select 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.
Posting grades
- 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. A dialog box will appear explaining how grades will be pushed from Gradescope to Canvas.
- In the dialog box, select Post Grades. 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."
Posting Grades to Canvas only sends the raw scores to Canvas. Students will not be able to view their graded submissions, question-by-question scores, rubrics, or feedback in Gradescope until grades are published. See, step 6.
- For fully graded submissions: only the overall score will be posted to your Canvas Gradebook. These assignments will have a checkmark next to them on the Review Grades page (indicating they have been posted) in Gradescope.
- For ungraded or partially graded submissions: When you post grades to Canvas with the latest version of the Gradescope tool (LTI 1.3), a dash displays next to ungraded submissions and an alert icon next to any partially graded submissions.
- To have students also see their graded, annotated submissions, question-by-question scores, rubrics, and feedback on Gradescope, select the Publish Grades.
- To alert students via email that their grades are now visible, select the Compose Email to Students at the bottom of the Review Grades page.
To see what your students will see when they view their grades, check out the article on Using Gradescope with Canvas as a Student.
If you have issues posting grades to Canvas, see the Troubleshooting Canvas Issues article or contact help@gradescope.com.