LTI Integration in Wittario
Questions about Wittario's LTI 1.3 integration — what it does, who it's for, and how to set it up.
## What is LTI?
LTI stands for **Learning Tools Interoperability**. It is an industry standard (maintained by 1EdTech, formerly IMS Global) that lets Learning Management Systems (LMS) — such as Canvas, Moodle, Blackboard, Brightspace, and itslearning — securely connect to external learning tools.
Wittario supports **LTI version 1.3**, the latest and most secure version of the standard.
---
## What does the LTI integration do in Wittario?
The LTI integration lets organisations connect their LMS directly to Wittario so that:
1. **Instructors can embed Wittario games in their LMS courses** — without leaving the LMS, instructors browse and select Wittario games to add as course activities.
2. **Learners launch Wittario games with single sign-on** — when a student clicks an activity link in the LMS, they are automatically signed in to Wittario and taken straight to the game. No separate Wittario login is needed.
3. **Scores are sent back to the LMS gradebook automatically** — when a learner completes a Wittario activity, their score is posted back to the LMS gradebook so instructors can track progress alongside other coursework.
### Summary of capabilities
| Capability | What it means for you |
|---|---|
| **Deep Linking** | Instructors pick Wittario games from within the LMS and add them as course activities |
| **Single Sign-On Launch** | Learners click an activity link and go straight into the game — no extra login |
| **Automatic Grade Passback** | Scores appear in the LMS gradebook automatically after learners complete a game |
| **Automatic User Provisioning** | Wittario accounts are created automatically on first launch — no manual user setup |
| **Organisation Auto-Membership** | Users who launch via LTI are automatically added to the correct Wittario organisation |
---
## Who is the LTI integration for?
The LTI integration is designed for **schools, universities, and training organisations** that already use an LMS and want to incorporate Wittario's gamified learning activities into their courses.
It is relevant for any organisation that uses one of the following LMS platforms (or any LMS supporting LTI 1.3):
- Canvas
- Moodle
- Blackboard
- Brightspace (D2L)
- itslearning
- Google Classroom (with LTI support)
- Other LTI 1.3-compatible platforms
---
## What do I need before setting up LTI?
Before starting the setup you need:
1. **A Wittario organisation** — your organisation must exist in Wittario. Create one if you do not already have one.
2. **Admin access to your LMS** — someone with administrator privileges in the LMS needs to register Wittario as an external tool.
3. **Admin access to Wittario Studio** — either a Wittario system owner or an organisation administrator in Wittario Studio.
---
## How to set up LTI for your organisation
Setting up LTI involves two sides: **registering Wittario in your LMS** and **registering your LMS in Wittario**. Both steps are needed.
### Step 1 — Register Wittario as an external tool in your LMS
In your LMS administration panel, add a new **LTI 1.3 tool** (sometimes called an "external tool" or "app").
> These URLs can also be found in Wittario Studio under the LTI page for your organisation.
After saving, the LMS will provide you with several values that you need for Step 2:
- **Issuer URL** — the LMS's OIDC issuer (e.g. `https://canvas.instructure.com`)
- **Client ID** — the OAuth 2.0 client ID assigned to Wittario
- **Authorization Endpoint** — the LMS's OIDC authorization URL
- **Token Endpoint** — the LMS's OAuth 2.0 token endpoint
- **JWKS URI** — the LMS's public key endpoint
- **Deployment ID(s)** — one or more deployment identifiers
> **Tip:** Many LMS platforms publish their OIDC configuration at a well-known URL like `{issuer}/.well-known/openid-configuration`. This contains the authorization endpoint, token endpoint, and JWKS URI.
### Step 2 — Register your LMS as a platform in Wittario
1. Open **Wittario Studio** and go to your organisation's settings.
2. Navigate to the **LTI** section.
3. Click **Add Platform**.
4. Fill in the values you received from your LMS:
| Field | What to enter |
|---|---|
| **Name** | A friendly name for this connection (e.g. "Our Canvas Production") |
| **Issuer URL** | The issuer URL from your LMS |
| **Client ID** | The client ID assigned by the LMS |
| **Authorization Endpoint** | The LMS OIDC authorization URL |
| **Token Endpoint** | The LMS OAuth 2.0 token URL |
| **JWKS URI** | The LMS public key URL |
| **Deployment IDs** | The deployment ID(s) from the LMS (one per line, if multiple) |
5. Click **Save**.
The connection is now established. Instructors can immediately start adding Wittario activities to their LMS courses.
### Step 3 — Add a Wittario game to an LMS course
1. In your LMS course, use the option to add an **external tool activity** (the exact menu name varies by LMS).
2. Select **Wittario** from the list of configured tools.
3. A Wittario content picker opens where instructors can browse available games.
4. Select the game(s) to add and choose the launch mode:
- **New window** — the game opens in a separate browser tab
- **Embedded (iframe)** — the game appears inline within the LMS page
5. Confirm the selection. The game is now available as an activity in the course.
### Step 4 — Learners play the game
When a learner clicks the Wittario activity link in the LMS:
1. They are automatically signed in to Wittario (no separate login required).
2. They are taken directly to the game.
3. When they complete the game, their score is automatically sent back to the LMS gradebook.
---
## Frequently Asked Questions
### Do learners need a separate Wittario account?
No. Wittario accounts are created automatically the first time a learner launches a Wittario activity through the LMS. On subsequent launches, the same Wittario account is reused automatically.
### Which LMS platforms are supported?
Any LMS that supports the LTI 1.3 standard will work with Wittario. This includes Canvas, Moodle, Blackboard, Brightspace, itslearning, and many others.
### Are scores sent back to the LMS automatically?
Yes. When a learner completes a Wittario game, their score is automatically posted to the LMS gradebook. The maximum possible score is based on the total points available in the game's tasks.
### Can we use LTI with multiple LMS instances?
Yes. You can register multiple LMS platforms in Wittario. Each platform is an independent connection with its own credentials.
### What happens if a learner's email changes in the LMS?
Wittario uses a persistent mapping between the LMS user identifier and the Wittario account. Even if the learner's email changes in the LMS, they will continue to use the same Wittario account.
### Can instructors also access Wittario through LTI?
Yes. When a user with an instructor role launches Wittario via LTI, they are directed to **Wittario Studio** (the content management app) instead of the player app. This lets instructors manage and configure games without leaving the LTI workflow. Instructors are assigned the "GameMaster" role in the Wittario organisation.
### Does the game need to belong to a specific organisation?
Yes. For security, a game can only be launched via LTI if it belongs to the same Wittario organisation that the LMS platform is linked to. If the game belongs to a different organisation, the launch will be blocked.
### Is HTTPS required?
Yes. All LTI communication uses HTTPS. This is a requirement of the LTI 1.3 standard.
### What is a Deployment ID?
A Deployment ID identifies a specific installation of the tool within an LMS. Some LMS platforms have multiple deployments (e.g. separate sub-accounts in Canvas). You should add all relevant deployment IDs when registering the platform. If you leave the deployment IDs field empty, Wittario will accept launches regardless of deployment ID.
### Where can I find the Wittario tool URLs?
The tool registration URLs are displayed in Wittario Studio on the LTI settings page for your organization.
### I'm having trouble connecting — what should I check?
1. Verify that all URLs (issuer, authorization endpoint, token endpoint, JWKS URI) are entered correctly in Wittario — they must match exactly what the LMS provides.
2. Make sure the Client ID in Wittario matches the one assigned by the LMS.
3. Check that the Organisation ID is set on the platform record in Wittario.
4. If using deployment IDs, make sure the LMS deployment ID is included in the list.
5. Contact Wittario support at **support@wittario.com** if you continue to experience issues.
---
## Contact and Support
For help with setting up LTI or troubleshooting connection issues, contact the Wittario team:
- **Email:** support@wittario.com
- **Website:** https://www.wittario.com
> **Purpose:** This document provides structured information for the HubSpot AI chatbot to answer customer questions about Wittario's LTI 1.3 integration — what it does, who it's for, and how to set it up.
---
## What is LTI?
LTI stands for **Learning Tools Interoperability**. It is an industry standard (maintained by 1EdTech, formerly IMS Global) that lets Learning Management Systems (LMS) — such as Canvas, Moodle, Blackboard, Brightspace, and itslearning — securely connect to external learning tools.
Wittario supports **LTI version 1.3**, the latest and most secure version of the standard.
---
## What does the LTI integration do in Wittario?
The LTI integration lets organisations connect their LMS directly to Wittario so that:
1. **Instructors can embed Wittario games in their LMS courses** — without leaving the LMS, instructors browse and select Wittario games to add as course activities.
2. **Learners launch Wittario games with single sign-on** — when a student clicks an activity link in the LMS, they are automatically signed in to Wittario and taken straight to the game. No separate Wittario login is needed.
3. **Scores are sent back to the LMS gradebook automatically** — when a learner completes a Wittario activity, their score is posted back to the LMS gradebook so instructors can track progress alongside other coursework.
### Summary of capabilities
| Capability | What it means for you |
|---|---|
| **Deep Linking** | Instructors pick Wittario games from within the LMS and add them as course activities |
| **Single Sign-On Launch** | Learners click an activity link and go straight into the game — no extra login |
| **Automatic Grade Passback** | Scores appear in the LMS gradebook automatically after learners complete a game |
| **Automatic User Provisioning** | Wittario accounts are created automatically on first launch — no manual user setup |
| **Organisation Auto-Membership** | Users who launch via LTI are automatically added to the correct Wittario organisation |
---
## Who is the LTI integration for?
The LTI integration is designed for **schools, universities, and training organisations** that already use an LMS and want to incorporate Wittario's gamified learning activities into their courses.
It is relevant for any organisation that uses one of the following LMS platforms (or any LMS supporting LTI 1.3):
- Canvas
- Moodle
- Blackboard
- Brightspace (D2L)
- itslearning
- Google Classroom (with LTI support)
- Other LTI 1.3-compatible platforms
---
## What do I need before setting up LTI?
Before starting the setup you need:
1. **A Wittario organisation** — your organisation must exist in Wittario. Create one if you do not already have one.
2. **Admin access to your LMS** — someone with administrator privileges in the LMS needs to register Wittario as an external tool.
3. **Admin access to Wittario Studio** — either a Wittario system owner or an organisation administrator in Wittario Studio.
---
## How to set up LTI for your organisation
Setting up LTI involves two sides: **registering Wittario in your LMS** and **registering your LMS in Wittario**. Both steps are needed.
### Step 1 — Register Wittario as an external tool in your LMS
In your LMS administration panel, add a new **LTI 1.3 tool** (sometimes called an "external tool" or "app").
> These URLs can also be found in Wittario Studio under the LTI page for your organisation.
After saving, the LMS will provide you with several values that you need for Step 2:
- **Issuer URL** — the LMS's OIDC issuer (e.g. `https://canvas.instructure.com`)
- **Client ID** — the OAuth 2.0 client ID assigned to Wittario
- **Authorization Endpoint** — the LMS's OIDC authorization URL
- **Token Endpoint** — the LMS's OAuth 2.0 token endpoint
- **JWKS URI** — the LMS's public key endpoint
- **Deployment ID(s)** — one or more deployment identifiers
> **Tip:** Many LMS platforms publish their OIDC configuration at a well-known URL like `{issuer}/.well-known/openid-configuration`. This contains the authorization endpoint, token endpoint, and JWKS URI.
### Step 2 — Register your LMS as a platform in Wittario
1. Open **Wittario Studio** and go to your organisation's settings.
2. Navigate to the **LTI** section.
3. Click **Add Platform**.
4. Fill in the values you received from your LMS:
| Field | What to enter |
|---|---|
| **Name** | A friendly name for this connection (e.g. "Our Canvas Production") |
| **Issuer URL** | The issuer URL from your LMS |
| **Client ID** | The client ID assigned by the LMS |
| **Authorization Endpoint** | The LMS OIDC authorization URL |
| **Token Endpoint** | The LMS OAuth 2.0 token URL |
| **JWKS URI** | The LMS public key URL |
| **Deployment IDs** | The deployment ID(s) from the LMS (one per line, if multiple) |
5. Click **Save**.
The connection is now established. Instructors can immediately start adding Wittario activities to their LMS courses.
### Step 3 — Add a Wittario game to an LMS course
1. In your LMS course, use the option to add an **external tool activity** (the exact menu name varies by LMS).
2. Select **Wittario** from the list of configured tools.
3. A Wittario content picker opens where instructors can browse available games.
4. Select the game(s) to add and choose the launch mode:
- **New window** — the game opens in a separate browser tab
- **Embedded (iframe)** — the game appears inline within the LMS page
5. Confirm the selection. The game is now available as an activity in the course.
### Step 4 — Learners play the game
When a learner clicks the Wittario activity link in the LMS:
1. They are automatically signed in to Wittario (no separate login required).
2. They are taken directly to the game.
3. When they complete the game, their score is automatically sent back to the LMS gradebook.
---
## Frequently Asked Questions
### Do learners need a separate Wittario account?
No. Wittario accounts are created automatically the first time a learner launches a Wittario activity through the LMS. On subsequent launches, the same Wittario account is reused automatically.
### Which LMS platforms are supported?
Any LMS that supports the LTI 1.3 standard will work with Wittario. This includes Canvas, Moodle, Blackboard, Brightspace, itslearning, and many others.
### Are scores sent back to the LMS automatically?
Yes. When a learner completes a Wittario game, their score is automatically posted to the LMS gradebook. The maximum possible score is based on the total points available in the game's tasks.
### Can we use LTI with multiple LMS instances?
Yes. You can register multiple LMS platforms in Wittario. Each platform is an independent connection with its own credentials.
### What happens if a learner's email changes in the LMS?
Wittario uses a persistent mapping between the LMS user identifier and the Wittario account. Even if the learner's email changes in the LMS, they will continue to use the same Wittario account.
### Can instructors also access Wittario through LTI?
Yes. When a user with an instructor role launches Wittario via LTI, they are directed to **Wittario Studio** (the content management app) instead of the player app. This lets instructors manage and configure games without leaving the LTI workflow. Instructors are assigned the "GameMaster" role in the Wittario organisation.
### Does the game need to belong to a specific organisation?
Yes. For security, a game can only be launched via LTI if it belongs to the same Wittario organisation that the LMS platform is linked to. If the game belongs to a different organisation, the launch will be blocked.
### Is HTTPS required?
Yes. All LTI communication uses HTTPS. This is a requirement of the LTI 1.3 standard.
### What is a Deployment ID?
A Deployment ID identifies a specific installation of the tool within an LMS. Some LMS platforms have multiple deployments (e.g. separate sub-accounts in Canvas). You should add all relevant deployment IDs when registering the platform. If you leave the deployment IDs field empty, Wittario will accept launches regardless of deployment ID.
### Where can I find the Wittario tool URLs?
The tool registration URLs are displayed in Wittario Studio on the LTI settings page for your organization.
### I'm having trouble connecting — what should I check?
1. Verify that all URLs (issuer, authorization endpoint, token endpoint, JWKS URI) are entered correctly in Wittario — they must match exactly what the LMS provides.
2. Make sure the Client ID in Wittario matches the one assigned by the LMS.
3. Check that the Organisation ID is set on the platform record in Wittario.
4. If using deployment IDs, make sure the LMS deployment ID is included in the list.
5. Contact Wittario support at **support@wittario.com** if you continue to experience issues.
---
## Contact and Support
For help with setting up LTI or troubleshooting connection issues, contact the Wittario team:
- **Email:** support@wittario.com
- **Website:** https://www.wittario.com