Configuring Gradescope LTI 1.3 in Moodle

Step One - Configuring Moodle

1. Log in to your Gradescope account that has the integration permissions enabled. It contains details that need to be copied into your Moodle 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 Moodle from the drop-down menu. 

4. Two headings will appear: Gradescope and LMS Details. The details under the Gradescope heading need to be copied into Moodle. Once that has been done, Moodle will provide you with the information required in the LMS Details section.

    

   

5. Open a new tab in your browser and log in to your Moodle administrator account. 

6. Select Site Administration and search for Manage Tools in the search bar.

7. Select the Manage Tools result.

8. Inside the Add tool box, select configure a tool manually.
   

9. From the External Tool configuration page, copy the details listed on the Gradescope page. Ensure you copy the details for the following fields:

   • Tool URL
   • Public keyset
   • Initiate login URL
   • Redirection URL
   • Ensure the LTI Version is set to LTI 1.3.

10. If your institution uses the gradescope.ca, gradescope.eu, or gradescope.com.au instance, in the Custom parameters box, add one of the following:

    • Gradescope.eu users enter - preferred_geography=eu
    • Gradescope.ca users enter - preferred_geography=ca
    • Gradescope.com.au users enter - preferred_geography=ap
    • If you are using gradescope.com, you can leave this box blank
      

11. Set the Tool configuration usage to display in the activity chooser as a preconfigured tool.

12. Set the Default launch container to either Existing Window or New Window.

13. Ensure the Supports Deep Linking box is ticked.
    
    
14. From the Services drop-down, configure the settings to show:
    • IMS LTI Assignment and Grade Services: Use this service for grades sync and column management
    • IMS LTI Names and Role Provisioning: Use this service to retrieve members’ information as per privacy settings
    • Tool Settings: Use this service
15. From the Privacy drop-down, configure the settings to show:
    • Share launcher’s name with tool: Always
    • Share launcher’s email with tool: Always
    • Accept grades from the tool: Always
    • Force SSL: Check
      
16. Select Save Changes.
    • Gradescope will now appear as an option for your instructors, but they will receive error messages until the deployment stage in Step 3 is complete if they attempt to create Gradescope courses or assignments via the LTI links in Moodle.

Step Two - Configuring in Gradescope

Now that you have set up the necessary details in Moodle, you'll need to copy the details back to Gradescope.

1. To access the required information, return to the Manage Tools page in Moodle.

2. Under the Tools heading, your Gradescope configuration is listed at the top.

3. Select the View configuration details icon (depending on the version you are using, this will either be stacked lines or a magnifying glass).
   

4. Copy the details provided from Moodle’s Tool configuration details modal and paste them into the LMS Details section in Gradescope. Ensure you provide details for:

   • Platform ID

   • Client ID

   • Public keyset URL

   • Access token URL

   • Authentication request URL

5. Select Save on the Gradescope configuration page. 
   

Step Three - Deployment

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

1. Access a Moodle course and select + Add an activity or resource.

2. Select External Tool.

3. Enter an activity name and select Gradescope from the Preconfigured tool drop-down. Gradescope will be listed as whatever you have named it in the External Tool configuration page.

4. Select the Select Content button.
   

5. You may be prompted to log in to Gradescope if you are not already. Please ensure you are logging into the account that has had the integration permissions enabled.

6. Enter your Branded Platform Name and select your school. This will be the name that instructors will see in Gradescope when referring to your Moodle integration. We recommend using a name that instructors will easily associate with your Moodle LMS.
   
   In the example shown in the picture below, the Branded Platform Name was set as “Moodle”. If the Branded Platform Name was set as “Moodle Test Account,” the button would read as “Post Grades to Moodle Test Account”. 
   
   
   

   We do not recommend naming this field “Gradescope” as it may confuse instructors.

7. Select Save and return to course.

8. Test the integration from the instructor and student sides. To do so, follow our Moodle guidance for instructors and Moodle guidance for your students.