Table of Contents

Configuring Gradescope LTI 1.3 in Brightspace (D2L)


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

  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. 

  1. Select Create new registration and then select Brightspace from the drop-down menu. Two headings will appear, Gradescope and 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.

  1. Open a new tab in your browser and log into your Brightspace (D2L) administrator account. 
  2. Select the settings cog from your homepage and then select Manage Extensibility.
  3. Select LTI Advantage from the top navigation and then select the Register Tool button. 

  1. Select Standard
  2. Leave Enabled turned on.
  3. In the Name field, enter “Gradescope” or a similar phrase so that your instructors will recognize it as your Gradescope integration.
  4. Copy each of the following details into the corresponding fields on the Gradescope configuration page. 
    1. Domain
    2. Redirect URLs
    3. OpenID Connect Login URL
    4. Target Link URL 
    5. Keyset URL
  5. Select all of the options for Extensions and Roles
  6. Complete the Custom Parameters box 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.


Custom Parameters Name

Custom Parameters Value








  1. Select Register.  A modal will appear with the details which need to be copied across into Gradescope. 
  2. 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. 
    1. Client ID
    2. Brightspace Keyset URL 
    3. Brightspace OAuth2 Access token URL
    4. OpenID Connect Authentication Endpoint
    5. Brightspace OAuth2 Audience
    6. Issuer

  1. Select Save on 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

  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 recognise as your Gradescope integration.
  7. Select all three Extensions
  8. Select all options under the Security Settings except for Anonymous




  1. Select Add Org Units, and then select all Org Units and Unit Types that should have access to Gradescope. 
  2. Select Create Deployment.

We recommend creating two links: one course-level Basic Launch link and one assignment-level Deep Linking Quicklink. Repeat this process 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.



  1. Leave Enabled turned on.
  2. In the Name field, enter “Gradescope” or something your instructors will recognise as your Gradescope integration.
  3. For the URL field enter
  4. For your link Type, we recommend you create two types in the order listed below. You can only create one link type at a time.
    1. For an assignment level link, select Deep Linking Quicklink and set the width and height values to 800
    2. For a course level link, select Basic Launch.
    Screenshot of both linking settings side-by-side


  1. Select Save and Close. Gradescope will now appear as an option for your instructors, but they will receive error messages until the final deployment stage in Step Four is complete if they attempt to create Gradescope courses or assignments via the LTI links in Brightspace.

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 recommend not naming this field “Gradescope” as it may cause confusion to instructors.

  1. 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.

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?

Configuring Gradescope LTI 1.3 in Blackboard

Configuring Gradescope LTI 1.3 in Canvas