Canvas launch, course linking, and score sync (draft)
Status
This page supplements the main Canvas LTI Integration guide with launch, linking, and blocked-state copy approved for customer docs (2026-05-29).
Overview
TeachFront can be launched from Canvas using LTI 1.3. Depending on your role, you may also:
- Link a Canvas course to a TeachFront course
- Sync assignments between TeachFront and Canvas
- Send scores back to Canvas (when your course is linked and configured)
Who this is for
- Students: launching TeachFront from Canvas and linking your account
- Instructors / teaching team: linking a course and syncing assignments
- Support/internal: triage of visible blocked states (without Canvas/API internals)
Launch TeachFront from Canvas (students and instructors)
- Open your course in Canvas.
- Select TeachFront in the course navigation.
- When prompted, sign in to TeachFront (or create an account).
- Continue into your course.
Screenshots needed
- Canvas course navigation with TeachFront link
- TeachFront sign-in prompt launched from Canvas
- Successful post-launch state in TeachFront
If you see an invalid or expired launch message
Use this user-facing copy:
Please return to Canvas and open TeachFront from your course menu. If the issue continues, contact your instructor or TeachFront support.
If the course is not found or not linked
Use this user-facing copy:
This Canvas course has not been linked to TeachFront yet. Please ask your instructor to complete the course link in TeachFront.
Link a Canvas course to TeachFront (instructors / teaching team)
Linking connects a Canvas course to a TeachFront course so assignment sync and score return can work.
- Launch TeachFront from your Canvas course.
- In TeachFront, open the Link course prompt/modal (shown during initial launch for unlinked courses).
- Select the TeachFront course you want to connect to this Canvas course.
- Complete the link flow.
Screenshots needed
- Link course modal (loading state)
- Link course modal (no available courses state)
- Linked course confirmation state
Set up grade conversion (during linking)
During linking, TeachFront may ask you to enter percentage thresholds so scores can be returned to Canvas in a points/percentage format.
- In the grade conversion step, enter percentage values for your grade distinctions.
- Fix any ordering/validation errors shown in the form.
- Save to continue.
Screenshots needed
- Grade conversion modal (empty state)
- Grade conversion validation error state
Sync assignments from TeachFront to Canvas (teaching team)
- Open your TeachFront course.
- Go to Assignments.
- Select Sync assignments.
- Wait for the sync to complete.
Screenshots needed
- Assignments page with Sync action
- Sync in-progress/loading state
- Sync success confirmation (if shown)
Payment or slot blocked after linking
After linking, students may still be blocked. These are linked-but-blocked states, not failed enrollment:
- No slots available: the student is linked to the course but needs a slot. The instructor may need to add membership slots under Course Settings > Billing.
- Payment required: the student is linked to the course; payment is needed to proceed. Direct them to complete checkout from the course or payment prompts.
Screenshots needed
- Dashboard landing state for No Slots Available
- Dashboard landing state for Payment Required
Score sync expectations
When your course is linked and configured, TeachFront can send scores back to Canvas.
Score-return failures (support/internal): OAuth/HTTP failures are not surfaced as detailed user-visible errors today. Customer docs should not promise public troubleshooting copy for score-return failures unless product adds it. Instructors who do not see expected scores in Canvas should confirm linking, grade conversion, and assignment sync, then contact support with course and assignment details.
Troubleshooting (limited)
- If you don’t see expected scores in Canvas, confirm:
- the course is linked
- grade conversion percentages were saved
- assignments were synced (if your workflow requires it)
- If the issue persists, contact support and include:
- the course
- the assignment
- what you expected to see in Canvas
- and when you last attempted a sync