---
title: Set up your Moodle integration
description: This guide provides all you need to know about configuring and testing your Moodle LTI integration with Perlego.
---
[Skip to content](https://organisations.perlego.com/support/help-centre/set-up-your-moodle-integration#main-content)
[Contact Us](https://organisations.perlego.com/support/help-centre/kb-tickets/new?hsLang=en)
[](https://www.perlego.com)
Open main navigation
Close main navigation
- [Contact Us](https://organisations.perlego.com/support/help-centre/kb-tickets/new)
- [Go to Perlego](https://www.perlego.com/)
[Go to Perlego](https://www.perlego.com/)
How can we help?
- There are no suggestions because the search field is empty.
1. [Organisation Help Centre](https://organisations.perlego.com/support/help-centre?hsLang=en)
2. [Integrations](https://organisations.perlego.com/support/help-centre/integrations?hsLang=en)
3. [Learning Management Systems (LMS)](https://organisations.perlego.com/support/help-centre/integrations?hsLang=en#learning-management-systems-lms)
# Set up your Moodle integration
## This guide provides all you need to know about configuring and testing your Moodle LTI integration with Perlego.
**Included**: Ultimate
**Add-on required:** Essential, Enhanced
Read more about [plans](https://26048107.hs-sites-eu1.com/knowledge-base/explore-perlegos-subscription-plans?hsLang=en) and [add-ons](https://26048107.hs-sites-eu1.com/knowledge-base/unlock-additional-features-and-services-with-perlego-add-ons?hsLang=en).
### Table of contents
1. [About the Moodle integration](https://organisations.perlego.com/support/help-centre/set-up-your-moodle-integration#about-the-moodle-integration)
2. [Configure your Moodle integration](https://organisations.perlego.com/support/help-centre/set-up-your-moodle-integration#configure-your-moodle-integration)
1. [Install the Perlego LTI tool into Moodle](https://organisations.perlego.com/support/help-centre/set-up-your-moodle-integration#install-the-perlego-lti)
2. [Send Perlego your ClientID, LMS URL and default access link](https://organisations.perlego.com/support/help-centre/set-up-your-moodle-integration#send-perlego-your-clientid)
3. [Testing](https://organisations.perlego.com/support/help-centre/set-up-your-moodle-integration#testing)
1. [Basic LTI launch and deep linking launch](https://organisations.perlego.com/support/help-centre/set-up-your-moodle-integration#basic-lti-launch-and-deep-linking-launch)
4. [Troubleshooting](https://organisations.perlego.com/support/help-centre/set-up-your-moodle-integration#troubleshooting)
### About the Moodle integration
The integration allows **Moodle** admins and instructors to deep-link titles from Perlego to a module within a course.
When a student clicks on a Perlego link they are automatically directed to create their account and once registered they will be automatically logged in, creating a seamless experience for your students.
### Configure your Moodle integration
> Before you start the configuration make sure:
>
> - Your organisation is on the [Ultimate plan](https://organisations.perlego.com/support/help-centre/explore-perlegos-subscription-plans?hsLang=en) OR you have purchased the LMS integration as an [add-on](https://organisations.perlego.com/support/help-centre/purchase-add-ons-for-your-organisation?hsLang=en).
> - You have System Admin access to your **Moodle** instance.
> - You have a test course within **Moodle**.
>
> - You have created an [**access link**](https://26048107.hs-sites-eu1.com/knowledge-base/create-and-manage-access-links?hsLang=en) for new registrations to be sent to.
#### 1. Install the Perlego LTI tool into Moodle
1. In the **Moodle** Admin menu, navigate to the **Site Administration** page, click on `Plugins`, click on `External Tool` option and then click on the **`Manage Tools`** link.
2. Enter `https://perlego.ltiaas.com/register` in the **Tool URL** field.
.png?width=688&height=107&name=Untitled%20(6).png)
3. Click on the `Add LTI Advantage` button. Alternatively, you can select to **configure a tool manually** and *skip to step 7*.
4. Perlego will now appear in the **Tools** section, it should be `pending`. .png?width=339&height=420&name=Untitled%20(7).png)
5. Click on the `Edit` icon. 
6. You should see the **Tool settings** page below. .png?width=688&height=480&name=Untitled%20(8).png)
7. Ensure that the **tool settings** match our **API settings**. They should be populated automatically.
- Tool URL: `https://perlego.ltiaas.com/lti/launch`
- Public key type: `Keyset URL`
- Public Keyset URL: `https://perlego.ltiaas.com/lti/keys`
- Initiate Login URL: `https://perlego.ltiaas.com/lti/login`
- Redirection URI(s): We have 3 URIs for redirection. Ensure all three are inputted into the field each on a new line.
```
https://perlego.ltiaas.com/lti/launchhttps://perlego.ltiaas.comhttps://perlego.ltiaas.com/
```
8. Copy the `Client ID` and make a note of it - you’ll need it later.
9. Scroll down to the **Tool configuration usage section** in the form and select `Show in activity chooser and as a preconfigured tool` in the drop-down.
10. In the **Default launch container** section of the form select `New Window` in the drop-down.
11. Under **Privacy,** ensure that **Share launcher’s email with tool** is set to `Always` .
12. **Save** the changes.
13. You will be redirected to **Plugins → Manage tools → Add tool. **
14. Click on the `Activate` button.
Here's a quick video walkthrough of the installation steps.
#### 2. Send Perlego your ClientID, LMS URL and default access link
Send us the `ClientID` you’ve generated and your **Moodle URL** by completing our [**LMS** set up form](https://share-eu1.hsforms.com/1DhUwjqHPQjiY1w4HxyQb1Qfiauj), so we can complete the registration.
You’ll also need to tell us which [**access link**](https://26048107.hs-sites-eu1.com/knowledge-base/create-and-manage-access-links?hsLang=en) your **LMS** users should be directed to when signing up to Perlego. If you don’t have an access link yet, you’ll need to create one in Perlego. This requires a Perlego admin login.
If you set up the tool manually, you will have to email all your **Tool configuration details** to [integrations@perlego.com](mailto:integrations@perlego.com).
.png?width=688&height=386&name=Untitled%20(9).png)
### Testing
#### Basic LTI launch and deep linking launch
These steps are to test Basic **LTI** and deep linking launch in **Moodle**.
1. Toggle the `Edit Mode` on the **right top navigation bar** in **Moodle**. To activate Edit Mode, it should change from grey to blue as shown in the image below.
2. Click on the **Home** menu and then `Add an activity or resource`. 
3. On the **pop-up modal** search for **Perlego**.
4. Select **Perlego**. Then you should see the **Adding a new External** **tool** page. 
5. Click on `Select content`. 
6. The Perlego content selector should display. 
7. Search the content you want to add, or scroll down and select the content. 
8. Click on **`Submit`** and you should see the image below. 
9. Click on `Save and Return to course` or `Save and display` button. You should see the content here. 
10. Click on the `external tool link`. You should be redirected to your Perlego access code or get logged into Perlego if you have an existing account.
### Troubleshooting
If you get the **Something went wrong** error, follow these steps:
1. First re-check all of the tool settings.
2. If they are correct, then check if the **Moodle** user you are logged in with is enrolled as a participant on your test course. If they are not, enrol them and test again.
3. If that doesn’t work, try creating a student user and testing with it. For more details follow the [Moodle documentation.](https://docs.moodle.org/404/en/Add_new_users)
1. To Create a new user, go to **Site administration** → **Users → Accounts** and click `Add a new user` . 
2. Fill out the form and create the user. Go to **Site administration** → **Users → Add a new user**
3. Add the user as a participant in a course. Go to **Home** → **Available courses → [Add a new course.](https://sandbox.moodledemo.net/course/view.php?id=2) **
4. Click on `My First Course` , then click on `Enrol Users`, select the user and click on the `Enrol Users` button. 
5. Go back to **My first course**, click on the **course tab** then click on `Add an activity or resource`. 
6. Search Perlego. 
7. Follow the steps on how to add Perlego content in step 4 above.
8. Log in as the newly created user.
9. Click on **`Available courses` → [My first course](https://sandbox.moodledemo.net/course/view.php?id=2)**
10. Click on the Perlego content that was added to the course. 
11. The user will be redirected to Perlego to create an account.
If you are still hitting the error contact integrations@perlego.com.
- [Getting started](https://organisations.perlego.com/support/help-centre/getting-started?hsLang=en)
- [Analytics](https://organisations.perlego.com/support/help-centre/analytics?hsLang=en)
- [Content](https://organisations.perlego.com/support/help-centre/content?hsLang=en)
- [FAQs](https://organisations.perlego.com/support/help-centre/faqs?hsLang=en)
- [General](https://organisations.perlego.com/support/help-centre/general?hsLang=en)
- [Integrations](https://organisations.perlego.com/support/help-centre/integrations?hsLang=en#main-content)
- [Single Sign-On (SSO)](https://organisations.perlego.com/support/help-centre/integrations?hsLang=en#single-sign-on-sso)
- [Learning Management Systems (LMS)](https://organisations.perlego.com/support/help-centre/integrations?hsLang=en#learning-management-systems-lms)
- [Library Discovery](https://organisations.perlego.com/support/help-centre/library-discovery?hsLang=en)
- [Managing Users](https://organisations.perlego.com/support/help-centre/managing-users?hsLang=en)
- [Organisation Account](https://organisations.perlego.com/support/help-centre/organisation-account?hsLang=en)
- [Support](https://organisations.perlego.com/support/help-centre/support?hsLang=en)
- [Troubleshooting](https://organisations.perlego.com/support/help-centre/troubleshooting?hsLang=en)
- [AI Tools](https://organisations.perlego.com/support/help-centre/ai-tools?hsLang=en)
[](https://perlego.com)
Organisation Help Centre
Copyright © 2026, Perlego Limited
```json
{
"@context" : "https://schema.org",
"@type" : "VideoObject",
"contentUrl" : "https://26048107.fs1.hubspotusercontent-eu1.net/hubfs/26048107/Screen_Recording_2023-09-14_at_12.08.25.mov",
"dateModified" : "2024-05-13T14:31:10.998Z",
"duration" : "PT20S",
"height" : 894,
"name" : "Screen_Recording_2023-09-14_at_12.08.25",
"thumbnailUrl" : "https://26048107.fs1.hubspotusercontent-eu1.net/hubfs/26048107/Screen_Recording_2023-09-14_at_12.08.25.mov/medium.jpg",
"uploadDate" : "2024-05-13T14:31:10.992Z",
"width" : 1444
}
```
```json
{
"@context" : "https://schema.org",
"@type" : "VideoObject",
"contentUrl" : "https://26048107.fs1.hubspotusercontent-eu1.net/hubfs/26048107/Screen_Recording_2023-09-14_at_12.40.03.mov",
"dateModified" : "2024-05-13T14:37:02.667Z",
"duration" : "PT55S",
"height" : 894,
"name" : "Screen_Recording_2023-09-14_at_12.40.03",
"thumbnailUrl" : "https://26048107.fs1.hubspotusercontent-eu1.net/hubfs/26048107/Screen_Recording_2023-09-14_at_12.40.03.mov/medium.jpg",
"uploadDate" : "2024-05-13T14:37:02.662Z",
"width" : 1444
}
```