Table of Contents

Configuring Gradescope LTI 1.3 in Canvas

Updated

Configuring Gradescope LTI 1.3 in Canvas as an Administrator

Before you can begin configuring your LTI 1.3 integration, please contact your Account Manager or Gradescope Integrations Lead so that we can enable the integration permissions to your account. Once you have received our confirmation that your Gradescope account has the necessary permissions, you can continue onto the first step.

Don't have a Gradescope account? Go to the Gradescope website and select Sign Up. Select the Instructor role, fill out the provided form and ensure you use the same email address you use on Canvas. You will be emailed with a link to set a password so that you are able to access your new account.

 You can install the Gradescope LTI 1.3 Canvas integration at either the root account or sub-account level depending on your institution’s preferences. Both installation approaches will work with the inherited key and manual key setups. We recommend installing at the sub-account level if certain departments have their own sub-accounts and you want to make the Gradescope LTI links available for some departments, but not others. We recommend that you complete the configuration process all at once. If you think you may need to complete it in stages, use your test Canvas environment.

To begin setting up your Canvas integration, select the setup tab that is right for your institution. Gradescope.com users can use either the inherited key or the manual key configuration. Gradescope.ca/.eu/.com.au users must use the manual key configuration. 

  • Inherited key setup  - This configuration method uses the default Placement settings that will display Gradescope LTI links in the Course Navigation menu, the Course Assignments menu in Canvas, and the External Tool submission menu. This setup has fewer steps and is only available for gradescope.com users.
  • Manual key setup -  This configuration method allows you to customize the Placement settings where Gradescope LTI links will display in Canvas. For example, you could specify for instructors and students to see the Gradescope LTI link at the assignment level but not at the course level (in the left-hand course navigation menu). This setup is available for both gradescope.com and gradescope.ca/.eu/.com.au users.
  1. To register LTI 1.3 in Canvas, log in as your LMS Administrator.
  2. Navigate to the Admin page using the left main menu and select your institution’s account name.
  3. Select Developer Keys. This option will not appear on any sub-accounts and must be set up using the main parent account.  
  4. Select Inherited and ensure Gradescope is set to On

 

  1. Select Settings, then Apps, and then View App Configurations.
  2. Select the blue + App button. A modal will appear.
  3. Set the Configuration Type to By Client ID and then enter the ID from the inherited Developer Key - 170000000000720. Select Submit and then Install

Gradescope will now appear as an option for your instructors, but they will receive error messages until step 4 in the Deployment section is complete if they attempt to create Gradescope courses or assignments via the LTI links in Canvas.

Step One - Configuring in Canvas

  1. Log into your Gradescope account that has the integration permissions enabled. It contains details that need to be copied into your Canvas integration configuration page. 
  2. Once logged in, select LTI 1.3 Integrations from the left side navigation and then select Configure Integration in the bottom right corner. If the “LTI 1.3 Integrations” option is not listed, please check you are logged into the correct account and then contact your account manager to have the integration permissions enabled.  
     
  3. Select Create new registration and then choose Other from the drop-down menu. Change the Registration Name to Canvas or a preferred name for your Canvas integration.
  4. Two headings will appear, Gradescope and LMS Details. The details under the Gradescope heading need to be copied into Canvas. 
  5. Now that you have the information you need, open a new tab in your browser and log into your Canvas administrator account. 
  6. Select Admin from the left navigation menu and select your institution’s name.
  7. Select Developer Keys, + Developer Key, and then + LTI Key.
  8. Ensure Method is set to Manual Entry. 
  9. For the Key Name, Title, and Description fields we recommend using “Gradescope” or something your instructors will recognise as your Gradescope integration.
  10. For the Owner Email field, we recommend using your integration administrator’s email address. 
  11. Insert the information provided from Gradescope into the following fields:
    1. Tool Public Key set URL into Public JWK URL
    2. Login Initiation URL into OpenID Connect Initiation Url
    3. Launch URL/Tool Redirect URL into Redirect URIs
    4. Target Link URI into Target Link URI
  12. The JWK Method should be set to Public JWK URL.
  13. Select the LTI Advantage Services drop-down and ensure the top 6 options are enabled.
    1. Can create and view assignment data in the gradebook associated with the tool. 
    2. Can view assignment data in the gradebook associated with the tool. 
    3. Can view submission data for assignments associated with the tool. 
    4. Can create and update submission results for assignments associated with the tool. 
    5. Can retrieve user data associated with the context the tool is installed in.
    6. Can update public jwk for LTI services. 
       
  14. Expand the Additional Settings dropdown. If your institution will be using the gradescope.ca, gradescope.eu, or gradescope.com.au instance, in the Custom Fields box add one of the following:
    1. Gradescope.eu users enter - preferred_geography=eu
    2. Gradescope.ca users enter - preferred_geography=ca
    3. Gradescope.com.au users enter - preferred_geography=ap
    4. Note: If you are using the gradescope.com instance, you can skip this and go to substep d.

    5. Ensure the Privacy Level is set to Public. 
  15. For Placements, add your preference for where Gradescope will display for your instructors and students:
    1. Course Navigation - Displays Gradescope as an option in the course navigation menu on the left sidebar. If configured, this placement will display by default for all courses at your institution at the sub-account or root account level (depending on where you’re installing the integration). This allows instructors and students to access the linked Gradescope course and all assignments through their Canvas course's dashboard.
    2. Tip: Individual instructors can hide the Course Navigation link (which will display by default) from their Course Settings in Canvas. 

      Note: Without the Course Navigation placement, instructors and students will have to access Gradescope course-level settings and functions like Roster Sync by backtracking and using a specific assignment's link. This could result in instructors having trouble locating the option to sync the course roster as well as students having trouble finding Gradescope assignments that may not be linked to Canvas.

      <
    3. Course Assignments Menu - Displays Gradescope as an option in the dotted drop-down menu (three dots icon) in the top right corner on the Assignments page. This allows instructors to link new Canvas assignments to Gradescope.
    4. Tip: We recommend this placement for instructors because it can be located easily and requires the least amount of click work to find. 

      Note: Either the Course Assignments or Assignment Selection placement is required in order for instructors to link new Canvas assignments to Gradescope.

      A screen capture of the dotted menu with the course assignments placement of Gradescope.
    5. Assignment Selection - Displays Gradescope as an option for instructors within the Canvas assignment and is configured on the individual assignment page in the Submission Type section. This allows instructors to link and create the assignment as an external tool submission.
  16. Leave the settings within the Course Navigation blank, but for Course Assignments Menu and Assignment Selection ensure Select Message Type is set to LtiDeepLinkingRequest.
     
  17. You have completed the Developer Key set up, select Save
  18. Gradescope will now be listed within your Developer Keys. Ensure its State is changed to ON
  19. Setup Gradescope to be an external app within Canvas.
    1. Copy the Client ID from beneath the Details column of your newly created Gradescope developer key. 
    2. Select Settings from the left sidebar navigation. 
    3. Select the Apps tab and then View App Configuration
    4. From here you can create a new External App. Select the + App button.
    5. Change the Configuration Type to By Client ID and enter the ID that you copied from the Developer Key Details column. 
    6. Select Submit and then Install to confirm.
    Gradescope will now appear as an option for your instructors, but they will receive error messages until the deployment stage is complete if they attempt to create Gradescope courses or assignments via the LTI links in Canvas.

    Step Two - Configuring in Gradescope

    1. Now that you have configured the necessary details in Canvas, you need to enter details into Gradescope. Return to the LTI 1.3 configuration page within Gradescope. 
    2. Under the LMS Details heading, enter the following information into the listed fields:
      1. Platform public key set URL -  https://canvas.instructure.com/api/lti/security/jwks
      2. Issuer -  https://canvas.instructure.com
      3. Client ID - Copy the Client ID from beneath the Details column of your newly created Gradescope developer key. 
      4. Access Token URL-  https://canvas.instructure.com/login/oauth2/token
      5. OpenID connect login endpoint - https://canvas.instructure.com/api/lti/authorize_redirect
      6. Leave Platform authorisation provider blank.

     

    1. Select Save on the Gradescope configuration page. 

    Sync sections  

    Gradescope allows for instructors to sync sections from Canvas to the Sections field of the Gradescope roster page. Instructors will only be shown this option if it is first added to the Custom Fields setting in Canvas by a user that has LMS permissions for their institution. 

    The Sections field on the Gradescope roster is used for grading questions by section and is an added column in all data exports. To enable the option for all instructors:

    We do not recommend allowing section syncing if your section names contain commas. The section name will not be imported correctly, and students may be assigned to multiple sections. For example, if a section is named "Section A, Monday" a student will be assigned to "Section A" and "Monday."
    1. Log in to your Canvas administrator account.
    2. Navigate to the Admin page using the left main menu and select your institution’s account name. 
    3. Select Developer Keys.
    4. Navigate to your Gradescope LTI 1.3 integration and select the pencil icon to edit the settings. 
    5. Select Additional Settings.
    6. In the Custom Fields box add - section_names=$com.instructure.User.sectionNames
    If the Custom Fields box already contains information, add the section data to a new line. 
    1. Select Save.

    Sections will now be automatically synced from Canvas to Gradescope when an instructor syncs their roster in Gradescope. 

    Coming soon! We are working on functionality that will allow assignments to be managed by sections. This will hopefully include the ability to set different assignment dates, restrict assignment access, and a simpler workflow for grading by section.

Deployment

Gradescope is now installed and will be listed within your External Tools. To complete the configuration, we need to link it to your account so that it can be used by instructors and students. 

  1. Select Courses from the main menu on the left and select a course.
  2. Select Gradescope which is now listed within your course sidebar navigation.
  3. You may be prompted to log into Gradescope if you are not already. Please ensure you are logging into the account that has had the integration permissions enabled. 
  4. Enter your Branded Platform Name and select your school. This will be the name that instructors will see in Gradescope when referring to your Canvas integration. We recommend using a name that instructors will easily associate with your Canvas LMS. 
In the example shown in the picture below, the Branded Platform Name was set as “Canvas”. If the Branded Platform Name was set as “Canvas Test Account” the button would read as “Post Grades to Canvas Test Account”. We recommend not naming this field “Gradescope” as it may cause confusion to instructors.

You’re done! Your instructors are now able to link their Canvas courses to Gradescope, sync rosters, create and link assignments, and sync grades between Gradescope and Canvas. Want to know how? Check out our Canvas instructor guidance. We also provide guidance for your students.

Adding the external Gradescope app at course level? If the Gradecope app is added at the sub-account level, the initial deployment will only need to be completed once. If the external Gradescope app is added at an individual course level or to courses not held within the sub-account, the deployment steps will need to be repeated each time. 

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 Canvas as an Instructor

Contact