Blackboard (LTI 1.3) Setup Instructions
Before you Start
You’ll need:
- Admin access in Forage for Educators (to generate a Client ID)
- A Blackboard admin role (to register and install LTI tools)
- Your Blackboard environment type:
- Blackboard Learn / Ultra (self-hosted or managed hosting)
- Blackboard SaaS (most common for new Ultra instances)
Blackboard requires LTI tools to be registered in the Blackboard Developer Portal first. After registration, institutions can install the tool in Blackboard using the Client ID (Application ID).
Administrator Configurations
Step 1: Create new integration record and get client ID (Forage)
- Log into Forage for Educators as an Admin: https://educator.theforage.com/
- Go to LMS Integrations → Add Integration → Select Blackboard
- Click Copy to clipboard to copy the Client ID.
Step 2: Install / Enable Forage in Blackboard (Admin)
The exact menu names can vary by Blackboard version, but the flow is generally:
- In Blackboard Admin settings, go to the area for LTI Tool Providers / LTI 1.3 Tools / Integrations.
- Choose Install or Register LTI 1.3/Advantage Tool.
- Paste the Client ID from Step 1.
- Click Submit / Install.
- Ensure the tool is Enabled/Available for the desired organizational scope (institution, node, or course availability depending on your setup).
- Copy the Deployment ID.
Step 3: Add Deployment ID to Forage for Educators (Admin)
The exact menu names can vary by Blackboard version, but the flow is generally:
- Once the Forage LTI App is installed successfully, navigate back to the Forage platform
-
Find Blackboard from the LMS integrations list, click on the ellipses, and choose Set Deployment ID.
-
In the opening modal, paste the deployment ID from Step 2 and click Save.
Instructor Guide
Instructors can add forage resources to a Blackboard course with the following steps:
- Open the target Blackboard course.
- Turn Edit Mode on (if applicable).
- Add a new piece of course content (e.g., Content → Build Content, or Add Content in Ultra).
- Select the Forage LTI tool.
- Choose the Forage simulation/content to embed from the Forage content selector.
- Save / publish the item so learners can access it.
Student Experience
- Student opens the course item that launches Forage.
- Blackboard launches Forage embedded in Blackboard.
- First-time launches may prompt the learner to create a Forage account; returning learners should be signed in automatically.
- Learner starts/continues the simulation; progress is saved in Forage.
Optional: Grade Passback (LTI AGS)
If your institution wants completion/score sent back to Blackboard:
- Ensure AGS is enabled during Step 2 (installation).
- Create the Blackboard item as an LTI graded activity (where supported).
- Confirm the grading scheme (points vs complete/incomplete) aligns with the course setup.
Support & Troubleshooting
Common issues:
- Tool not visible to instructors (tool not enabled at the right scope)
- Incorrect Client ID/Application ID used during install
- Missing AGS permissions (grade passback not working)
- Launch errors due to redirect URL mismatch
For support, email: fg_forage-support@eab.com
Include:
- Blackboard version/environment (SaaS vs Learn/Ultra)
- Client ID/Application ID
- Screenshot(s) of the tool registration + installation screens
- Error message and course identifier