Skip to main content

Configuring Gradescope LTI 1.3 in Brightspace (D2L) for Admins

Configuring Gradescope LTI 1.3 in Brightspace (D2L)

Before you can begin configuring your LTI 1.3 integration, please email us at 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.

If you don’t have an account yet, 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 Brightspace (D2L). You will be emailed with a link to set a password so that you are able to access your new account.

The configuration process consists of steps in both Brightspace (D2L) and Gradescope. Having both apps open in separate tabs could make the process easier. We recommend that you either complete the configuration process all at once, or on your test Brightspace (D2L) environment if you think it may need to be completed in stages. Let’s get started!


Step One - Registering LTI 1.3

Step One - Registering LTI 1.3

  1. Log into your Gradescope account that has the integration permissions enabled. It contains details that need to be copied into your Brightspace (D2L) 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 registrationand then select Brightspacefrom the drop-down menu. Two headings will appear, Gradescopeand LMS Details. The details under the Gradescope heading need to be copied into Brightspace (D2L). Once that has been done, Brightspace (D2L) will provide you with the information needed for the LMS Details section.
  4. Open a new tabin your browser and log into your Brightspace (D2L) administrator account.
  5. Select the settings cogfrom your homepage and then select Manage Extensibility.
  6. Select LTI Advantagefrom the top navigation and then select the Register Toolbutton.
  7. Select Standard.
  8. Leave Enabledturned on.
  9. In the Namefield, enter “Gradescope” or a similar phrase so that your instructors will recognize it as your Gradescope integration.
  10. Copy each of the following details into the corresponding fields on the Gradescope configuration page.
    • Domain
    • Redirect URLs
    • OpenID Connect Login URL
    • Target Link URL
    • Keyset URL
  11. Select all of the options for Extensionsand Roles.
  12. Complete the Custom Parametersbox as follows:
    • If you are using the instance, leave this box blank.
    • If you are using one of the following instances, enter the preferred_geography parameter as shown.
      Instance Custom Parameters Name Custom Parameters Value preferred_geography eu preferred_geography ca preferred_geography ap
  13. Select Register. A modal will appear with details that will need to be copied across into Gradescope.
  14. In the Brightspace (D2L) modal, copy each of the following details and paste them into the corresponding fields in the LMS Details section in Gradescope.
    • Client ID
    • Brightspace Keyset URL
    • Brightspace OAuth2 Access token URL
    • OpenID Connect Authentication Endpoint
    • Brightspace OAuth2 Audience
    • Issuer
  15. Optional: Sync student ID values from Brightspace (D2L) to Gradescope:

    We highly recommend syncing student ID values because it increases the accuracy of auto-matching of scanned exams to student names for instructor-uploaded exams.

    When student IDs are not synced from your LMS, instructors will have to manually assign student ID values via a CSV uploadon the Gradescope course roster. For more information, see the prepping your roster file section in the Adding Students and Staff article.

    • Make sure that the OrgDefinedId field in your Brightspace environment contains student ID values.
    • Select Config Variable Browserfrom the Admin settings (gear icon).
    • Paste d2l.Tools.Lti.SendLisPersonSourcedIdinto the search bar in the top right.
    • To edit the ID's properties, select the d2l.Tools.Lti.SendLisPersonSourcedIdID link under Name and Description.
    • For the Variable Properties, change the Instance Valueand Org Valueto On.
  16. Select Saveon the Gradescope configuration page.

If you leave the modal before copying the details across, you can locate them again by selecting the newly configured Gradescope tool from the LTI Advantage page. Scroll to the bottom of the settings, and the required Brightspace Registration Details will be displayed.

Step Two - Adding the Deployment Tool

Step Two - Adding the Deployment Tool

  1. Select the newly-configured Gradescope tool from the LTI Advantage page.
  2. Scroll to the bottom of the settings and select View Deployments.
  3. Select New Deployment.
  4. Leave Enabled turned on.
  5. Select your newly created Gradescope tool from the Tool dropdown.
  6. In the Name field, enter “Gradescope” or something your instructors will recognize as your Gradescope integration.
  7. Select all three Extensions.
  8. Select all options under the Security Settings except for Anonymous.
  9. Select your preferences for the Configuration Settings:
    • Open as External Resource (recommended) - enables the linked Gradescope course and assignments to open in a new tab. If not selected, Gradescope will open embedded within your D2L window.
    • Grades created by LTI will be included in Final Grade (recommended) - syncs the grades from Gradescope to your D2L gradebook and includes them in the final grade for the course. If not selected, the grades will show in the D2L gradebook but not be counted toward part of the final grade.
  10. Add Org Units and make sure to add all descendants, and then select any org units and unit types that should have access to Gradescope. Select Add to close this modal.
  11. Select Create Deployment.
Step Three - Create the LTI links

Step Three - Create the LTI links

We recommend creating two links: one course-level Basic Launch link and one assignment-level Deep Linking Quicklink. Repeat the process below for each link.

  1. Select the newly-configured Gradescope deployment. Scroll to the bottom of the settings and select View Link.
  2. Select New Link.
  3. Leave Enabled turned on.
  4. In the Name field, enter “Gradescope” or something your instructors will recognise as your Gradescope integration.
  5. For the URL, enter
  6. For your link Type, we recommend that you create two types in the order listed below. You can only create one link type at a time.
    • For an assignment-level link, select Deep Linking Quicklink and set the width and height values to 800.
    • For a course-level link, select Basic Launch.

      Creating a course-level link will allow instructors and students to access Gradescope course-level settings and functions like Roster Sync within their D2L environment. Without a Gradescope course-level link, they will have to backtrack and access these settings via the assignment 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 D2L.

      If you don't want the Gradescope LTI link to be visible in an instructor's course navigation menu, skip the previous step and go directly to step 7. For more information on customizing the Gradescope link for instructors, see step 8 in this section.
      Screenshot of both linking settings side-by-side

  7. Select Save and Close. Gradescope will now appear as an option for your instructors.

    For instructors to successfully create Gradescope courses or assignments via the LTI links in Brightspace (D2L), the Final Deployment Stage in step four must be completed. Otherwise instructors will receive error messages when they try do so.

  8. Customize the placement of the course-level Gradescope LTI link in the top navigation bar, depending on your institution's preferences.
    • Option 1: Display the Gradescope link for all instructors by default - This option enables the Gradescope link to always show for all instructors in their course navigation menu.
      1. On the Links page, select Manage All Course Navbars from the dotted menu. This will open the Navbars settings page.
      2. Select Top-Level Navigation from the Active Navbar list. You can also choose a different navigation bar you have customized.

        Make sure the navbar you are choosing is set to Default so that it shows up in the list.

      3. Scroll down and select the Top-Level Navigation link.
      4. On the Edit Navbar page, select Add Links from the Links section.
      5. Select Create Custom Link in the Add Links modal.
      6. In the Create Custom Link modal:
        • Enter a Name.
        • For the URL, select Insert Quicklink to open the Insert Quicklink modal.
        • Select External Learning Tools and then Gradescope.
        • Select Create to close this modal.
      7. Select Add to close the Add Links modal. Back on the Edit Navbars tab, you should now see Gradescope added (it may appear towards the end of your links list).
      8. Select Save and Close. You will see a confirmation message that the newly created link was saved.
    • Option 2 (Default): Instructor’s choice - This option lets your instructors decide whether or not to display the Gradescope link in their course navigation menu. For this option, no action is required from the administrator, but the instructor will need to complete the steps in the adding Gradescope to the course-level navbar section of the Brightspace Instructor guidance.
    • Option 3: Don’t display the Gradescope link at all - This option hides the Gradescope LTI course link from instructors so they won’t be able to add or modify it. For this option, you should skip creating a course-level link,
Step Four - Final deployment

Step Four - Final 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. Access a Brightspace (D2L) course and select the Content tab.
  2. Select your newly configured Gradescope option from the Add Existing Activities drop-down.
  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 a Branded Platform Name, such as “Brightspace” so your instructors will recognize this as your Brightspace integration within Gradescope.
  5. Select your school.

    In the example shown in the picture below, the Branded Platform Name was set as “Brightspace”. If the Branded Platform Name was set as “Brightspace Test Account” the button would read as “Post Grades to Brightspace Test Account”. We do not recommend naming this field “Gradescope” as it may cause confusion to instructors.
  6. You’re done! Your instructors are now able to link their Brightspace (D2L) courses to Gradescope, sync rosters, create and link assignments, and sync grades between Gradescope and Brightspace.

If you ever need to disable or re-enable an older LTI 1.3 integration, you can do so by navigating to the LTI 1.3 integrations page on your Gradescope account, selecting Edit next to the integration, and checking or unchecking the Disabled box.

Disabling an integration will unlink all courses and assignments between Gradescope and Brightspace and will remove the Sync Roster and Post Grades options. Re-enabling the integration will restore all the links.

Was this article helpful?
0 out of 0 found this helpful

Articles in this section

Powered by Zendesk