LMS Integration · Troubleshooting
Troubleshooting XYZ Homework in your LMS
Look up the exact message you see, likely causes and who can help. Say whether the problem is in the assignment picker, an assignment link or a missing grade; those need different checks.
For an ordinary assignment that opens blank or repeats sign-in: try a new tab. Browser storage inside an embedded frame can interfere with sign-in. This is a workaround for an assignment link, not a test of the assignment picker:
Canvas — “Load This Tool In A New Tab” on the assignment (instructors can set this).
Brightspace — “Open in a new tab” under Display Options (Content), or “Open as External Resource” (Classic Content), on the assignment link. A deployment setting applies to new links created afterwards; older links keep their settings. The Deep Linking picker stays in a frame. If the assignment stays framed or the picker fails, contact support.
Moodle — Launch container → New window, on the tool or the activity.
Blackboard — “Launch in New Window” on the placement. Administrator only.
Blocked third-party cookies can prevent embedded sign-in. Prefer opening ordinary assignments in a new tab. Safari has no per-site setting to allow cookies, so advice to allow cookies for XYZ alone cannot work there. Do not weaken browser security to troubleshoot. Use the ordinary-link workaround when available, or report an embedded-picker problem to support.
Start here (any LMS)
The assignment won’t load, is blank, or spins
Hard-refresh the page: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac).
For an ordinary assignment link, try a new tab. An embedded frame can interfere with sign-in. Use your LMS’s “open in new tab/window” option for the link. A content-selection picker is a different screen; tell support if that is where the problem occurs.
Disable any pop-up blocker for xyzhomework.com. When the embedded frame is blocked, XYZ Homework tries to open your assignment in a new window — a pop-up blocker stops that, and you may see Popup blocked, click to open in a new window. Click it.
Blocked third-party cookies can prevent embedded sign-in. Prefer opening ordinary assignments in a new tab. Safari has no per-site setting to allow cookies, so advice to allow cookies for XYZ alone cannot work there. Do not weaken browser security to troubleshoot. See the your LMS section below, or the error-message index. Check the setting’s scope: Canvas uses a per-assignment setting; Brightspace has per-link settings and a deployment option for links created afterwards, so older links need checking individually. On Moodle and Blackboard it can be set once for the whole tool. Brightspace’s Deep Linking picker still opens inside a frame.
I’m asked to sign in every time, or it won’t connect
Always launch from inside your your LMS course — not a saved bookmark of the XYZ page.
An instructor may need to sign in to connect the intended courses. If an ordinary assignment keeps asking, try a new tab. If the picker repeats sign-in, or a new tab does not help, contact support rather than creating another account or course connection.
Grades aren’t showing up in your LMS
Grades can take a few minutes to appear after work is finished and any required grade release is complete. Check that the student used the intended course link. If a score or column is still missing, contact support@xyzhomework.com with the assignment name and time. Support can check the connection and grade destination; a resend or column change needs the instructor’s approval and can affect existing grades.
Students don’t see a “Redeem LatePass” button
LatePasses work inside your LMS: the Redeem LatePass button appears on the assignment’s opening page under the due date (and in the assignment’s More menu) whenever a pass can be used. It is hidden when the student has 0 LatePasses.
Why a new student (or your LMS’s test student) has 0: students join the XYZ roster the first time they launch from your LMS, and receive the number in Course Settings → Additional Options → Auto-assign LatePasses on course enroll (default 0). Set that before the term starts; use Roster → Manage LatePasses for anyone who already launched.
Also check: the assessment allows LatePasses and has a due date before the course end date; the student hasn’t opened it in Practice mode (which blocks LatePass use); and your LMS has no “available until” lock date earlier than the LatePass extension. A LatePass changes the due date in XYZ Homework only — any your LMS late-submission policy still applies.
Error-message index
Search this page for the message you see (Ctrl/Cmd+F).
Each entry describes likely causes and who can help — student, instructor, or your
LMS administrator — because for several of these the person seeing the error is not the
person who can resolve it.
Messages from XYZ Homework
Error: State not found
Who fixes it: the student or instructor can work around it; an LMS admin can fix it for everyone.
What it means: XYZ Homework could not find the sign-in state for this launch. An expired or repeated launch, browser storage or a connection problem can cause this; the message alone does not identify which one.
Fix: go back to your LMS course and open a fresh assignment link. For an ordinary assignment, try a new tab: Canvas: “Load This Tool In A New Tab” on the assignment; Brightspace: “Open in a new tab” under Display Options (Content) or “Open as External Resource” (Classic Content); Moodle: Launch container → New window; Blackboard: “Launch in New Window” on the placement (admin only). Brightspace’s picker remains inside a frame. If it recurs, tell support which screen failed and when.
The on-screen text currently suggests enabling third-party cookies. That will not work in Safari, which has no per-site setting for it. Use the new-tab setting instead.
Error: Could not find registration details
Who fixes it: your LMS administrator, together with XYZ Homework support. An instructor cannot resolve this.
What it means: XYZ Homework could not match the registration details supplied for this launch. Manual setup may be incomplete, or the Platform ID or Client ID may not match. This error does not show that the rest of the launch succeeded.
Fix: we match your site by its Platform ID (issuer) as an exact string. https://lms.school.edu, https://lms.school.edu/ (trailing slash) and http://lms.school.edu are three different sites to the match. Copy the Platform ID and Client ID from your tool’s configuration details — copy, do not retype — and send both to support@xyzhomework.com for initial diagnostic triage.
Your administrator and XYZ support should compare the intended registration using the approved support channel. Dynamic Registration still needs administrator review and course availability checks; do not create a second registration to clear this message.
Brightspace manual setup needs more than the issuer and Client ID. Your administrator and XYZ support should follow the Brightspace setup and administrator handoff for the full required field list and obtain the exact approved Login URL, preserving ?u= if present. Do not guess values or create another registration.
Error: Could not find issuer · Error: Could not find login hint
Who fixes it: whoever opened the link.
What it means: the XYZ Homework launch address was opened directly — from a bookmark, a pasted URL, or a browser’s history — instead of being started by your LMS. The launch carries information that only the LMS can supply.
Fix: always start from the assignment link inside your course. Bookmarking the XYZ page itself will not work.
Popup blocked, click to open in a new window
Who fixes it: the person seeing it.
What it means: the embedded frame could not sign you in, so XYZ Homework tried to open your assignment in a new window — and the browser’s pop-up blocker stopped it.
Fix: click the message; it opens the window directly. To stop it recurring, allow pop-ups for xyzhomework.com, and ask for the new-tab setting described under State not found so the frame is never used in the first place.
One more step to open your assignment — “your browser is still blocking the cookie”
Who fixes it: the person seeing it can continue; the permanent fix is the LMS setting.
What it means: the same blocked-cookie situation as State not found, caught deliberately so you get a button instead of a failure.
Fix: click through to continue now. If you see this on every assignment, ask for the new-tab setting for your LMS — you should not have to click this each time.
Course link not established yet. Notify your instructor they need to click this assignment to set it up.
Who fixes it: the instructor. Students cannot resolve this and do not need to do anything.
What it means: a student reached an assignment before the instructor completed the one-time pairing between the LMS course and the XYZ Homework course.
Fix: the instructor opens the intended XYZ Homework link, signs in if asked, and connects the correct XYZ course. Then check that the affected assignment opens the right work. Course pairing alone does not confirm every copied link or grade association.
Error: course link already established · Invalid course to associate
Who fixes it: the instructor, sometimes with support.
What it means: this LMS course is already paired with an XYZ Homework course, and something is trying to pair it with a different one — commonly after a course copy, or when two instructors set the same course up.
Fix: if the existing pairing is correct, simply launch the assignment normally. If it points at the wrong XYZ course, email support@xyzhomework.com with the course name — do not create a second link.
Linked assessment appears to have been deleted
Who fixes it: the instructor.
What it means: the LMS link points at an XYZ Homework assignment that no longer exists.
Fix: the instructor checks the intended assignment and course connection with support. Replacing a link can affect its grade association; do not delete an existing link or grade column just to diagnose the message.
Unable to find deployment · Missing deployment_id
Who fixes it: your LMS administrator.
What it means: XYZ Homework could not identify an allowed deployment for this launch. On Brightspace, an incomplete deployment or missing course sharing is one possible cause.
Fix: the admin confirms the registration and its deployment are enabled, and that the deployment is shared to this course (Brightspace: Add Org Units).
Failed to fetch public key set · Unable to find public key
Who fixes it: your LMS administrator, with XYZ Homework support.
What it means: XYZ Homework could not retrieve your LMS’s public keys, so it cannot verify that the launch genuinely came from you. Usually the keyset address is wrong or unreachable from outside your network.
Fix: the administrator and support confirm the intended platform’s approved keyset URL and secure server connectivity. Do not disable certificate or signature checks, or substitute another site’s keys.
Nonce was already consumed
Who fixes it: the person seeing it.
What it means: the same launch was submitted twice — usually a page refresh, or the browser’s Back button returning to a launch that already completed. Each launch may be used once, which is a security requirement.
Fix: go back to your course and open the assignment link again rather than refreshing.
This LMS launch does not allow creating grade columns
Who fixes it: your LMS administrator.
What it means: this launch does not grant the column-management access needed for the requested action. That is different from permission to send scores to an existing column or read its results.
Fix: Canvas: Developer Key state ON with the grade scopes. Moodle: Assignment and Grade Services → “Use this service for grade sync and column management”. Brightspace: Assignment and Grade Services enabled on the registration and the deployment. Blackboard: “Allow grade service access” = Yes.
Ask the administrator and XYZ support which access the intended action needs. Do not add write permissions, create a column or resend a score simply to test connectivity.
Messages from your LMS about XYZ Homework
Moodle: The tool returned the following error message: …
This is Moodle showing you our message. Look the quoted text up in the section above — that entry is the real answer.
Moodle: Misconfigured tool. Please ask your Moodle administrator to fix the configuration of the tool.
Who fixes it: your Moodle administrator.
What it means: Moodle’s own check failed before the launch was attempted — typically a blank Initiate login URL (Moodle does not require it at save time, so it fails only at launch) or the wrong LTI version.
Fix: compare the tool against the value table on the Moodle setup page. The most common cause is confusing Tool URL (…/lti/launch.php) with Initiate login URL (…/lti/login.php).
Moodle: Moodle was unable to communicate with the … system
Who fixes it: your Moodle administrator.
What it means: your Moodle server could not reach xyzhomework.com — a proxy, firewall or TLS problem on the server, not in the browser.
Canvas: Client not authorized in requested context
Who fixes it: your Canvas administrator.
What it means: the Developer Key is off, or the app is not installed in this account or sub-account.
Fix: Admin → Developer Keys, set State to ON; then confirm the app is installed for the account the course belongs to.
Brightspace: Invalid Message Hint · Message Hint Expired (in the System Log)
Who fixes it: try a fresh launch; if it repeats, your Brightspace administrator and XYZ support can investigate.
What it means: Brightspace could not use the launch message hint, for example because it expired. This message alone does not identify why.
Fix: return to your course and open a fresh link. For an ordinary assignment, try Open in a new tab in Content or Open as External Resource in Classic Content. If it repeats, report the time and whether you were opening an assignment or the embedded picker; the new-tab workaround does not apply to that picker.
Still stuck?
Contact support@xyzhomework.com with your LMS/version, Content view, role, course and link title, time, browser, exact error text and any reference code. Say whether the picker or an assignment failed and whether a new tab helped. Crop screenshots to the problem and remove other students’ details. Do not send passwords, tokens, raw launch URLs or browser network captures. Support can request necessary account details through the private support channel.
By LMS
Canvas
I can’t find XYZ Homework when adding an External Tool
The app install isn’t finished. If your admin used Dynamic Registration, have them confirm under Admin → Apps → Manage that XYZ Homework is enabled with a placement. If they used the Developer Key path, they add it under Settings → Apps → + App → By Client ID. Until that’s done, instructors won’t see XYZ Homework in the tool list.
The tool opens then goes blank or loops back to a login
In the assignment, turn on Load This Tool In A New Tab, then Save & Publish. Canvas embeds tools in a frame by default, which can block the sign-in.
If it still fails, open the tool in a new tab — browsers increasingly block the sign-in cookie inside an embedded frame, and a new tab is the dependable fix.
Grades still aren’t passing back to the Canvas gradebook
Confirm the Developer Key State is ON (Admin → Developer Keys). A key left in the OFF state stops grade passback.
Make sure each XYZ assignment was added as its own External Tool link with points set, not pasted as a plain URL.
If a column never appears, the Client ID may not be registered with us yet — have your admin send it to support@xyzhomework.com so we can add it on our end.
I want Canvas due dates to apply in XYZ Homework
By default XYZ Homework enforces the due dates set in XYZ. There is a course setting that lets Canvas push its due dates into XYZ instead — enable it in the XYZ course settings if you’d prefer to manage dates from Canvas.
A student redeemed a LatePass, but Canvas still locks the assignment or marks it late
A LatePass extends the due date inside XYZ Homework only. Two Canvas assignment settings still apply:
Available until: if the Canvas assignment has an “Available until” date, Canvas locks the launch at that time regardless of the LatePass. Leave it blank, or set it later than the longest LatePass extension.
Late policies: Canvas records the work as submitted after its own due date, so an automatic late-deduction policy is applied on top of the LatePass. The policy is course-wide and cannot exclude individual assignments: turn it off, clear the late status on the affected submission in the Canvas gradebook, or move the Canvas due date to match the extension.
If students don’t see a LatePass button at all, see “Students don’t see a Redeem LatePass button” in the “any LMS” section above.
I imported the cartridge but the links don’t work yet
Open any one imported link once and complete the one-time instructor sign-in — that associates the Canvas course with your XYZ course and activates every imported link at once.
Added new XYZ assessments after importing? They don’t sync automatically — repeat the Export → Import step to bring the new links over.
Blackboard
XYZ Homework isn’t in the Content Market / Institution Tools
The tool isn’t fully registered yet. Your Blackboard admin must finish Register LTI 1.3/Advantage Tool, set Tool Status = Approved, and add a Deep Linking content tool placement. Only approved tools show under Institution Tools.
We don’t have a Client ID
Blackboard uses a Client‑ID model and the ID comes from us. Email support@xyzhomework.com for your institution’s XYZ Homework Client ID, then enter it when registering the tool.
The tool opens then goes blank or loops to a login
This one is set by your Blackboard administrator, not by instructors. It lives on the placement: Administrator Panel → Integrations → LTI Tool Providers → XYZ Homework → Manage Placements, edit the Deep Linking placement, tick Launch in New Window, and Submit.
Links created from that placement then open in a new window; there is no per-item override for instructors, which is why this has to go through your admin. Also allow pop-ups for xyzhomework.com. Both Blackboard Ultra and Original are supported.
Grades aren’t passing back
On the registered tool, Allow grade service access must be turned on (your admin sets this). Adding each XYZ assignment as its own deep-linked item is the most reliable way to get grades back; if a column is missing, also check the tool registration and the XYZ-side setup.
Moodle
I set the tool up manually and the launch errors out
Two things are usually missing, and the second one is invisible from inside Moodle:
- Initiate login URL must be
https://www.xyzhomework.com/imathas/lti/login.php. Moodle flags this field but doesn’t fill it in — if it’s blank the launch can never start. (It is not the same as the Tool URL, which is…/lti/launch.php.) - We have to register your Moodle on the XYZ Homework side. Moodle generates the Client ID itself — it isn’t issued by us, and it’s greyed out on your form for that reason. Until you send it to us along with the rest of the tool’s Details, XYZ Homework has no record of your site and every launch fails.
Open Manage tools, click View configuration details on the XYZ Homework card, and email the Platform ID and Client ID to support@xyzhomework.com. Those two are all we need — we derive the rest. We’ll add them and confirm.
Or skip all of it: delete the manual tool and use Dynamic Registration instead — paste https://www.xyzhomework.com/imathas/lti/dynreg.php into the Tool URL box in Manage tools and click Add LTI Advantage. It sets every field, service and privacy option correctly and needs nothing sent back to us.
We sent our details but launches still fail
We match your site by its Platform ID (issuer) as an exact string. https://moodle.school.edu,
https://moodle.school.edu/ (trailing slash) and http://moodle.school.edu are three
different sites as far as the match is concerned. Send the Platform ID exactly as Moodle shows it in the tool’s
Details panel — copy and paste it rather than retyping — and tell us if your Moodle’s address
has changed since the tool was registered.
XYZ Homework is stuck on “Pending” in Manage tools
Dynamic Registration created the tool but it still needs approval. Your Moodle admin clicks the checkmark next to XYZ Homework under Manage tools to set it Active.
XYZ Homework isn’t in the activity chooser
From your course page open More → LTI External tools and turn on Show in activity chooser for XYZ Homework. If it isn’t listed there either, the site-wide tool hasn’t been set up yet — use the send-to-administrator box above to email your Moodle admin everything they need.
There’s no “Select content” button / I can’t pick an assignment
Make sure the tool is Active (not Pending) and that you added it as External tool → XYZ Homework. Select content is what opens XYZ Homework to deep-link a specific assignment.
The tool opens blank or keeps asking me to sign in
Set the Launch container to New window. Either once for everyone — Site administration → Plugins → Activity modules → External tool → Manage tools, edit XYZ Homework, Show more…, Launch container — or per activity, by editing the activity and using the same Show more… setting.
Do this right after setup. Dynamic Registration configures the tool to launch embedded, without blocks, so a brand-new correctly-registered tool still lands inside the frame until you change this. Moodle itself warns that browsers may block the new window — so also allow pop-ups for xyzhomework.com.
The first launch asks the instructor to sign in once to link the courses.
Grades aren’t syncing to the Moodle gradebook
If the tool was set up manually, Assignment and Grade Services must be set to “Use this service for grade sync and column management.” Dynamic Registration sets this automatically. Add each assignment as its own activity.
Brightspace (D2L)
XYZ Homework is labeled “XYZ Homework (Disabled)”
Do not register it again. Your Brightspace administrator should first review the intended tool’s identity, URLs, requested services and data access, then enable it if approved. Check the deployment, course sharing and Deep Linking Quicklink as well.
XYZ Homework isn’t under External Learning Tools
In Classic Content, look under Existing Activities → External Learning Tools → XYZ Homework. In Content, use Add Existing → XYZ Homework, or choose the named entry directly if shown. If your institution has Immersive View, look in Add. What matters is the entry’s type: a Deep Linking Quicklink opens the picker; Basic Launch does not. If the Quicklink is missing, your administrator should check the intended registration, deployment, Add Org Units sharing, permissions and enabled link type. Do not create a duplicate registration.
Registration didn’t complete with “Dynamic”
Do not guess Standard-registration values or use a generic login URL. Contact support@xyzhomework.com so your Brightspace administrator and XYZ support can complete the intended setup.
The tool opens blank or loops to a login
Is it an assignment link or the assignment picker? For an ordinary assignment link, try opening it in a new tab: in Content, use Edit → Display Options → Open in a new tab; in Classic Content, use Edit Properties In-place → Open as External Resource. If the setting is missing or the link stays framed, contact support.
Your administrator can also set Open as External Resource on the deployment for new links created afterwards. Existing links keep their settings and may need an individual check. Allow the requested XYZ pop-up only if you are opening your own assignment from your course.
The Deep Linking picker is different: Brightspace opens it inside a frame. Opening an ordinary assignment in a new tab does not fix or test the picker. If selection is blank or repeats sign-in, report that you were using the picker, your browser and the time; do not change browser security settings or repeatedly register the tool.
Where are my gradebook columns?
Columns depend on the link placement and grade settings. Links embedded in an HTML page can behave differently from graded Content links. A launch does not guarantee column creation or repair. Ask your administrator to confirm the intended deployment has Assignment and Grade Services and is shared to the course; ask XYZ support to check the assignment’s existing grade association before creating, deleting or rebinding a column.
Grades aren’t passing back
Check that the student finished the assignment in the correct XYZ course and that any required manual grade release is complete. Your administrator can check Assignment and Grade Services, course sharing and the student’s gradable role. Name and Email disclosure must follow the institution-approved account setup; adding roster access is not a generic grade fix.
In Content, check whether the topic was changed with Edit Activity → Add and Manage Grade Items → Reset to Ungraded. A column can remain even when the topic is no longer graded. Ask support before changing an existing association.
Do not use Resend or Create All Grade Columns just to diagnose this. A resend can replace grades entered by hand in Brightspace and can include zero records for work a student opened but never answered, even when “Include zeros” is unchecked. Waiting until the due date does not protect manual edits or students with extensions. Let support and the instructor review the affected assignment and students before approving a resend.