Outdated Method
This guide explains how to connect Moodle to GMetrix using Learning Tools Interoperability (LTI) 1.1.
LTI 1.1 is an older connection standard. Do not use this method if your Moodle instance supports LTI Advantage (LTI 1.3). Use the Moodle LTI 1.3 setup guide instead.


Check which standard you're using

Your Moodle instance supports LTI 1.3 if you see "LTI Advantage" or are asked for any of the following:
• Client ID
• Registration URL
• OIDC URL

Even if your version of Moodle supports both versions of LTI, we recommend LTI Advantage (LTI 1.3). It's easier to manage and more secure.

Use LTI 1.1 to open GMetrix from Moodle when LTI 1.3 is unavailable. A Moodle administrator registers GMetrix once as an approved Tool Provider. Instructors can then create a separate course link for each GMetrix Course or Practice Exam.


Contact GMetrix Support before continuing with a self-hosted, district-wide, multi-school, or other complex implementation.


Before You Begin

Keep Moodle and the GMetrix Administrator Portal open in separate browser tabs while you follow this guide. Values shown in GMetrix take priority over examples in this guide.

  • Make sure you have access to the GMetrix Administrator Portal.

  • Make sure you have Moodle administrator permission to configure external apps for the intended account.

  • Do not share the Consumer Key or Shared Secret in email, screenshots, or course content.

Choose Where to Start

  • Configure the reusable tool: Complete Part 1 when GMetrix is not available as a preconfigured tool.
  • Add a resource: Skip to Part 2 when GMetrix is configured but the required Course or Practice Exam is not in the course.
  • Test an existing activity: Skip to Part 3 when the resource activity already exists.


Part 1: Register the GMetrix Tool Provider

A Moodle site administrator completes this part once for the intended site or course-category scope.


In Moodle

  1. From the sidebar, select Site administration.
  2. Select Plugins.
  3. Select Activity modules.
  4. Select External tool.
  5. Select Manage tools.
  6. Select Configure a tool manually.
  7. Enter GMetrix in Tool name.


In GMetrix: Copy the Connection Values

  1. In the GMetrix Administrator Portal, select Integrations from the sidebar.

  2. Locate the LTI 1.1 section.

  3. Switching between GMetrix and Moodle, copy and paste the GMetrix LTI 1.1 credentials into their corresponding Moodle fields


In Moodle: Paste the Connection Values

  1. Paste the GMetrix Launch URL into Tool URL.
  2. Select Legacy LTI 1.1 from the LTI version list.
  3. Paste the GMetrix Consumer Key into Consumer key.
  4. Paste the GMetrix Shared Secret into Shared secret.
  5. Leave Custom parameters blank.
  6. Select Show in activity chooser from the Tool configuration usage list.
  7. Select New window from the Default launch container list.
  8. Set Share launcher’s name with the tool to Always.
  9. Set Share launcher’s email with the tool to Always.
  10. Set Accept grades from the tool to Always.
  11. Save the tool.
  12. Confirm that GMetrix appears in Manage preconfigured tools.
Keep resource parameters out of the provider

Do not add accesscode or gmxresourcekey to the site-wide configuration. Add them to the activity for the specific resource.


Part 2: Add a GMetrix Resource

Complete this part once for each GMetrix Course or Practice Exam that is not already available in the Moodle course. Do not repeat Part 1.

In GMetrix

  1. In the GMetrix Administrator Portal, select Integrations from the sidebar.

  2. Locate the Link a Specific Resource section.

  3. Enter the Resource Key (gmxresourcekey) for the Course or Practice Exam.

    • Use the Look up button to find a specific resource key.

  4. Enter the Access Code for the intended Classroom or group.

    • Use the Look up button to find a specific Classroom or group's code.

  5. After the custom parameters appear, select Copy All Parameters.


In Moodle

  1. Open the intended course.
  2. Turn Edit mode on.
  3. Go to the course section where the resource should appear.
  4. Select Add an activity or resource.
  5. Select GMetrix from the activity chooser. Select External tool if GMetrix is not shown separately.
  6. Enter an activity name that identifies the resource.
  7. If Moodle asks for a tool, select GMetrix from the Preconfigured tool list.
  8. If Custom parameters is not visible, select Show more.
  9. Paste the generated accesscode and gmxresourcekey lines into Custom parameters exactly as provided.
  10. Configure the grade and availability settings for the activity.
  11. Select Save and display.


Part 3: Confirm the Resource

  1. Open the saved GMetrix activity.
  2. Confirm that GMetrix opens without another sign-in prompt.
  3. Confirm that the intended Course or Practice Exam opens.
  4. Test the activity with an appropriate learner account or role.

After Setup

Single sign-on (SSO)

The LTI connection signs learners in when they open GMetrix from Moodle.


Grade Passback

Supported Practice Exam scores can return to Moodle when the LMS item is configured for grading.


Resource management

Reuse the provider or app that is already configured. Add another resource-level link, activity, material, or app only when you need a different GMetrix resource.


Skills Management System (SMS)

Learners must install the desktop application for in-app tests. The macOS version is called SMSe. AutoCAD and Microsoft Office tests require SMS for Windows.

Additional Resources