Set up Moodle

Register RaeNotes as an LTI 1.3 external tool in Moodle, connect it to RaeNotes, and add the activity to a course. You need the Moodle site administrator role and a RaeNotes team you administer.

Keep the RaeNotes Integrations page open in a second tab — you will copy values in both directions. If you haven't read it yet, start with LMS integration (LTI 1.3) — overview.

Part 1 — Register RaeNotes in Moodle

1

Open the tool registration form

Go to Site administration → Plugins → Activity modules → External tool → Manage tools and click configure a tool manually.

2

Fill in the tool settings

Use the values from the RaeNotes Integrations page:

Moodle field Value
Tool nameRaeNotes (any name your teachers will recognise)
Tool URLRaeNotes Redirect URLhttps://app.raenotes.com/lti/launch
LTI versionLTI 1.3
Public key typeKeyset URL
Public keysetRaeNotes JWKS URLhttps://app.raenotes.com/lti/jwks
Initiate login URLRaeNotes Login URLhttps://app.raenotes.com/lti/login
Redirection URI(s)RaeNotes Redirect URLhttps://app.raenotes.com/lti/launch
Default launch containerNew window (recommended). Embedded containers also work, but a separate window gives students the full upload and player interface.
3

Enable grade services

Open the Services section:

  • IMS LTI Assignment and Grade ServicesUse this service for grade sync and column management. Without it RaeNotes cannot create the gradebook column or post results.
  • IMS LTI Names and Role Provisioning → leave it off. RaeNotes does not read course membership lists.
4

Share the launcher's name and email

In the Privacy section set Share launcher's name with tool and Share launcher's email with tool to Always.

This is required, not optional: RaeNotes matches or provisions the student's account from the email address in the launch. Without it launches fail.

5

Add the instructor email custom parameter (self-assessment only)

If you plan to use the Self-assessment with supervisor feedback workflow, add a line to Custom parameters naming the instructor who supervises these students — instructor_email=teacher@example.com

The part before = must match the Instructor email property field in RaeNotes (default instructor_email). A tool-level parameter applies to every activity created from this tool; if different courses have different supervisors, set the parameter per activity instead (Part 3 below).

Note. Moodle's LTI variable substitution cannot read custom user profile fields, so there is no way to derive the supervisor from the student's profile. Use a fixed email per tool or per activity.

6

Save the tool

Click Save changes. The tool now appears as a card on the Manage tools page.

Part 2 — Connect Moodle to RaeNotes

7

Open Moodle's configuration details

On the tool card click the list icon → View configuration details. Moodle shows the six values RaeNotes needs.

8

Create the platform in RaeNotes

In RaeNotes go to Integrations → Add LTI Platform and copy the values across:

Moodle configuration detail RaeNotes field
Platform ID (e.g. https://your.moodle.site)Issuer
Client IDClient ID
Deployment IDDeployment ID
Authentication request URL (…/mod/lti/auth.php)Authentication request URL
Access token URL (…/mod/lti/token.php)Access token URL
Public keyset URL (…/mod/lti/certs.php)Key Set URL
9

Pick the team and the workflow

Select the Team students will join (this cannot be changed later), then the workflow. For self-assessment keep Instructor email source at LTI launch custom parameter and make sure Instructor email property matches the custom parameter name you used in step 5. Click Add.

Part 3 — Add the activity to a course

10

Create an External tool activity

In the course, turn on editing and choose Add an activity or resource → External tool. Give it a name and select RaeNotes as the Preconfigured tool.

11

Check the activity's privacy and grade settings

  • Accept grades from the tool — enable it, otherwise the gradebook column is never populated.
  • Share launcher's name / email with the tool — leave as inherited from the tool configuration (Always).
  • Custom parameters (under Show more…) — use this to override instructor_email for this activity when the supervisor differs by course or cohort.
12

Test as a student

Open the activity with a test student account. You should land on the RaeNotes upload page. After processing, check that the gradebook column updates. If something is missing, see LTI troubleshooting.

Moodle documentation

Any questions? Contact us