Moodle Admin Setup

  • Updated

Upgrading from LTI 1.1 to LTI 1.3

For a full list of frequently asked questions regarding LTI 1.3, see 1.3 FAQ.

There are several benefits to upgrading to LTI 1.3. First, creating individual assignment links in your LMS is no longer necessary to sync individual assignment scores to your LMS. Students can use a generic Perusall link and individual assignment scores will still be sent to the LMS. You can still create individual assignment links, called “deep links” in LTI 1.3, which point to particular Perusall assignments even when the link and assignment do not have matching names. (Note: deep links are automatically created in Moodle as you create Perusall assignments.) Second, your LMS course roster automatically syncs to your Perusall course; instructors will be able to view the full roster in Perusall even before students ever launch into Perusall. That way, instructors can set up groups in advance of the start of the semester.

A few important notes about migrating an LTI 1.1 integration to an LTI 1.3 integration:

  • Users who initially created their Perusall account through an LTI 1.1 integration will receive a one time confirmation email the first time they launch Perusall through an LTI 1.3 integration.
  • Existing Perusall courses cannot be upgraded from LTI 1.1 to LTI 1.3; LTI 1.3 will only apply to newly-created courses. Since some LMSs do not allow for both a LTI 1.1 integration and a LTI 1.3 integration to be active simultaneously, we recommend switching over to LTI 1.3 between semesters. Previously created LTI 1.1 courses will not be deleted; instructors will still be able to access them from within their Perusall account even if they can no longer launch them from the LMS. 

Administrator Setup

Note: If you are using a Testing/Staging Instance, please remember to replace any urls starting in app.perusall with staging.perusall.

To set up Perusall as a tool in your Moodle instance, navigate to Site Administration >Plug Ins> External Tool > Manage Tools, and then select the option to configure the tool manually.

Fill out the fields as shown below, and then click Save changes.

Tool settings

  • Tool name: Perusall 1.3
  • Tool URL:
  • Tool description: The Perusall social learning platform
  • LTI version: LTI 1.3
  • Public key type: Keyset URL
  • Public keyset:
  • Initiate login URL:
  • Redirection URI(s):
  • Tool configuration usage: Show as preconfigured tool when adding an external tool
    • For users with new Moodle update, select Show in activity chooser and as a preconfigured tool.
  • Default launch container: New window
  • Supports Deep Linking: checked
  • Icon URL and Secure icon URL (under "Show more"):


  • IMS LTI Assignment and Grade Services: Use this service for grade 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


  • Share launcher's name with tool: Always
  • Share launcher's email with tool: Always
  • Accept grades from the tool: Always
  • Force SSL: checked

After you save the tool, click the list icon (to the left of the gear icon) under the tool on the Manage Tools page:

Perusall Tool Moodle.png

Click the square icon on the left of the list icon to reveal the Tool configuration details.

Screen Shot 2023-08-10 at 10.37.06 AM.png

Save these for the next (and final) step.

Add your LTI Platform through the Institution Dashboard:

  • To request institutional admin access for your Perusall account (register for an account), for security verification purposes, please email and point us to an institutional web page that shows your name, email address and title/affiliation.
  • Once Perusall has confirmed your request, you will see Institution Dashboard on your Perusall home page (to the left of Get Help), and you can navigate to Settings > LTI 1.3 integrations > Add a new LTI 1.3 integration.  Select your LMS type (Moodle), and insert your:
    • Platform ID
    • Client ID
    • Deployment ID
    • Authentication request URL
    • Access Token URL
    • Public Keyset URL
  • Click Ok to finalize your placement, and Save Changes.
    • Once your credentials have been entered into our platform list, you can refer your instructors to follow Moodle Instructor Setup.


Please whitelist messages coming from and to ensure users are able to receive our emails.

Related to

Share this article

Was this article helpful?

0 out of 1 found this helpful