Desire2Learn LTI 1.1

  • Updated

We have a new Perusall integration method available (it is called LTI 1.3). Benefits include: group sync, roster sync, seamless grade pass back, and no need for the Key & Secret! Learn more about the difference between the integrations.

For this setup process, your IT Administrator is required to do the installation. If your IT administrator chooses to proceed, they can view our set up guide here Desire2Learn Admin Setup

Step 1: Request Key & Secret

To connect Perusall to Desire2Learn (D2L), contact support@perusall.com to obtain the institution’s Consumer Key & Shared Secret. Please email in from your official university email address using the subject line “Key and Secret Request.” For security verification purposes, please provide a link to an institutional web page that shows your name, email address, and title/affiliation.

If your D2L administrator has already set up Perusall as a global tool in D2L, you can skip the installation instructions and go directly to Step 3: Create your Perusall Course.  Please check with your D2L administrator before proceeding.

Step 2: Install Perusall

  • Navigate to Course Admin > External Learning Tools > Manage Tool Providers > New Tool Provider.
  • Enter https://app.perusall.com/lti/launch in the Launch Point field.
  • Choose version 1.1 from the LTI Version dropdown menu.
  • Choose HMAC-SHA1 from the OAuth Signature Method dropdown menu.
  • Enter your institution’s Shared Secret.
  • Enable Use custom tool consumer information instead of default.
  • Enter your institution’s Consumer Key.
  • Enter Perusall in the Name field.
  • Enter “The Perusall social learning platform.” in the description field.
  • Enter support@perusall.com in the Contact email field.
  • Under Visibility, enable Allow users to use this tool provider.
  • Enable all security settings except Send system Org Defined ID to tool provider.
  • Click Add Org Units and select which courses to use.
  • Click Save and Close.

Step 3: Create your Perusall Course

  • In your D2L course, select a module, and click Existing Activities > External Learning Tools > Create new link.
  • The title can be anything such as "Perusall."
  • The LTI URL is https://app.perusall.com/lti/launch.
  • Select Legacy LTI Tool.
  • Click Create and Insert.
  • Click on the   beside the link > Edit Properties in Place, and enable Open as External Resource.
  • Refresh the page, and click the Perusall link that appears in the module to launch Perusall and create a D2L-linked Perusall course.

After you've set up your Perusall course, you can create assignment links in D2L for your students to access your Perusall course content.  When a student clicks on a Perusall link in your D2L course, a Perusall account will be created and they will automatically be enrolled in your course.

Grade Sync to your Desire2Learn Course 

You can sync students' average or total assignment scores OR students’ individual assignment scores back to D2L.  Click on the toggles below to learn more.

  • A student’s average score is each individual assignment score summed and then divided by the total number of assignments, while the total score simply takes the sum of across all assignments.

    Syncing the average or total score rather than individual assignment scores saves time because an instructor will only need to create one Perusall link in a D2L content area (or module) rather than an assignment link for each assignment. Students will access Perusall through this link.

    • Launch into your Perusall course> Click Settings > Scoring > scroll to Grade sync to LMS > select Automatically sync students' average or total scores back to the LMS > save.
    • Return to your D2L course, and Add a grade item to the Perusall link from Step 3: Create your Perusall course.  Set the Maximum points to the highest possible score a student can earn. 
      • For average grade sync, this can be found under Settings > Scoring > General > Assignment score range.
      • For total points sync, this is the total number of points of all Perusall assignments that students will be completing over the duration of your course.

    Students will click the Perusall link you created to access their Perusall assignments and Perusall will pass their average scores back to D2L as you release assignment scores in Perusall.

  • To sync students’ individual assignment scores, you will create assignment links in D2L for every assignment in Perusall.

    • Launch into your Perusall course > Click Settings > Scoring > scroll to Grade sync to LMS > select Automatically sync individual assignments scores back to the LMS > then save.
    • In Perusall, click: Course home > Assignments > select an assignment > Copy full title for LMS. The assignment name will be copied to the clipboard.
    • Return to your D2L course, select a Module > Existing Activities > External Learning Tools > Create New LTI Link.
    • Paste the assignment title in Title.
    • The LTI URL is https://app.perusall.com/lti/launch.
    • Select Legacy LTI Tool.
    • Click Create and Insert.
    • Click on the   beside the link > Edit Properties in Place, and enable Open as External Resource.
    • Refresh the page, and click the Perusall link that appears in the module to launch to test launch.  You should launch directly into the corresponding assignment in Perusall.  

    Repeat this process for each Perusall assignment.

    We suggest hiding the generic Perusall link (created in Step 3: Create your Perusall Course) from the students’ view in D2L so students only use the assignment-specific links, thereby ensuring grade sync works correctly.  You can do this by clicking beside the link > Hide from users.

When D2L first receives grades from Perusall (whether individual assignment grades or the average grade) to a particular link, it will by default create a new grade item out of 100. The numeric value will correspond to the percentage equivalent of the student's Perusall score. (For example, if you leave your Perusall course at the default 0-3 grade scale, D2L will show scores of 0, 33.3, 66.7, and 100 for Perusall scores of 0, 1, 2, and 3, respectively.)

If you prefer that the score in D2L be out of a different number of points, you can change the total number of points for the assignment by editing the associated grade item's Maximum points.

In order to successfully sync individual assignment scores, students must access each Perusall assignment by clicking its assignment-specific link in D2L. If a student does not, then Perusall will not be able to send the student's scores back to D2L.

See our general LMS troubleshooting page for other common issues.

Related to

Share this article

Was this article helpful?

1 out of 1 found this helpful