Troubleshooting
This page helps course authors and workspace owners find out why a slide does not behave as expected in a course. Each problem lists its likely causes, then the solutions, with a link to the page that explains the feature. The Messages section at the end lists the exact texts that learners and authors see.
Before you start
Section titled “Before you start”Three checks solve many problems:
- Test the slide in Try it first. If the slide answers there, its instructions and AI setup work, and the problem lies in the installation (code, course, site or learner). See Try it.
- Test the published course, not a preview. Storyline does not run JavaScript triggers in Preview, and authoring tool previews, share links and Review 360 never identify a learner. See Test before going live.
- Open Activity. On the Requests tab, set Status to Failed to list the failed AI calls, and the Overview page shows an Errors · last 24 h card and a Needs your attention card. A request refused before it reaches the AI provider (unpublished slide, site not allowed, credits or fair-use limit) is not recorded in Activity. See Activity and analytics.
If you install code yourself, the browser console (F12 in most browsers) also shows the messages written by the integration code. See Browser console messages.
The AI does not answer
Section titled “The AI does not answer”Nothing happens when the learner clicks in Storyline
Section titled “Nothing happens when the learner clicks in Storyline”This applies to the JavaScript integration code in Storyline and in the other authoring tools.
Causes
- You are testing in Storyline’s Preview, which does not run JavaScript triggers. Other authoring tool previews do not always run JavaScript either.
- The slide is still a draft. A course gets no answer from a draft.
- The Storyline variables do not have exactly the names used in the code.
- The ready-made Storyline slide lost its variables: its hidden
variableslayer was deleted, or Storyline’s variable dialog was answered with something other than Merge on a second import. - The code was copied before the slide was renamed. The generated variable names follow the slide title.
- The course runs on a site that is not in Allowed origins.
Solutions
- Publish the course to the web, to your LMS or to SCORM Cloud, and test it there. See Test before going live.
- Open the slide. If the installation step shows This slide is not published yet, select Publish (or Save and publish). See The slide editor.
- Compare the names under Storyline variables (Integration variables in the other authoring tools) with the variables in Storyline. Use the copy button next to each name to avoid typos. See Articulate Storyline (JavaScript).
- If you renamed the slide, see After renaming a slide, the code no longer matches.
- Create a text variable named like the answer variable followed by
_err(the editor shows it as Error variable when the slide has return variables). After a failed call, it holds a message such asSlideMind error (403). See SlideMind error codes.
The widget shows “Configuration not found.”
Section titled “The widget shows “Configuration not found.””This message appears inside the SlideMind widget (Rise 360 Code block, Storyline Web Object or HTML widget).
Causes
- The slide is a draft or is archived. The widget only serves published slides.
- The slide was deleted.
- The code in the course is incomplete or was edited by hand.
Solutions
- Publish the slide. Only the slide’s own status counts: publishing its course or module does not publish the slide. See Courses and modules.
- If the slide was deleted, create it again (or restore it from an export) and install the new code. See Import and export.
- Copy the code again with Copy the code (or Download the folder (.zip) for a Storyline Web Object) and replace it in your course. See Integration overview.
The widget shows “This widget is not available.”
Section titled “The widget shows “This widget is not available.””Cause
The workspace is not active: it is Suspended or Pending deletion.
Solutions
- If the workspace is pending deletion, its owner can select Restore workspace before the deletion date. See Delete or restore a workspace.
- If the workspace is suspended, contact support.
The widget stays blank or shows a browser error
Section titled “The widget stays blank or shows a browser error”Cause
The course runs on a site that is not in Allowed origins. The browser then refuses to display the widget, and SlideMind cannot show a message of its own.
Solutions
- Ask a workspace owner to open Settings › Integrations and add the site address to Allowed origins: one complete address per line, such as
https://lms.example.com, without a path. An empty list allows every site. - If your LMS shows the course inside a frame served from another address, add that address too.
- To test on a preview or review platform, add its address, or have an owner select Enable for 24 hours under 24-hour CORS test mode, then End test mode when you finish.
See Allowed websites.
The learner sees “The AI assistant is temporarily unavailable”
Section titled “The learner sees “The AI assistant is temporarily unavailable””The full message is “The AI assistant is temporarily unavailable. Please try again later or contact your course provider.” The widget never shows the technical reason to learners.
Causes
- The workspace runs on SlideMind Credits and the credits are exhausted.
- The workspace reached its fair-use limit: learner chats are paused until the 1st of next month (UTC).
- No AI is connected: the workspace uses its own API keys and has no key for the slide’s provider.
- With SlideMind Credits, the slide’s model is not in the catalogue or is not available on your plan.
- SlideMind Credits cannot run for this workspace, for example because it has no billing account.
- The workspace became inactive (suspended or pending deletion).
Solutions
- Check the Overview page. In SlideMind Credits mode, its SlideMind Credits block reads “Credits are exhausted — learners are blocked.” when the balance is empty. Key problems appear in the Needs your attention card. See Overview dashboard.
- The workspace owner buys credits with Add credits in Account › Billing. See SlideMind Credits.
- When the fair-use limit is reached, the Overview page shows Learner chats are paused, and Activity shows the count under its title. Chats start again on the 1st of the month (UTC). To have the limit raised sooner, select Contact support on that line in Activity. See Activity and analytics.
- Connect an AI in Settings › AI & models: turn on SlideMind Credits or add a provider key. See Choosing how AI is funded.
- Choose another model for the slide. See Models and response settings.
- If the workspace has no billing account, contact support.
The widget keeps waiting, or shows “The assistant is loading. One moment, please.”
Section titled “The widget keeps waiting, or shows “The assistant is loading. One moment, please.””Cause
Many learners use SlideMind at the same moment, for example a whole class starting the activity together.
Solutions
- Nothing to do in most cases. The loading page reloads itself after a few seconds, and during an activity the widget keeps its typing indicator while it retries on its own.
- If the busy moment lasts, the learner sees “Too many requests right now. Please try again in a moment.” and can send again a little later.
The learner sees “Something went wrong. Please try again.”
Section titled “The learner sees “Something went wrong. Please try again.””Causes
- The AI provider returned an error or did not answer in time.
- With your own API keys, the provider rejected the key, or no longer offers the slide’s model.
- The slide’s Reasoning effort is not supported by its provider.
- The slide was unpublished or deleted while the learner had the widget open.
Solutions
- Look for the failed call in Activity. See Activity and analytics.
- Test the key and check the model. See A model is no longer available, or the provider key is invalid.
- Choose another Reasoning effort for the slide. See Models and response settings.
- Run the slide in Try it to reproduce the problem. See Try it.
Learner memory does not work
Section titled “Learner memory does not work”No value is saved
Section titled “No value is saved”Check what was saved for a learner in Memory › Learner data, by searching for the learner’s complete identifier.
Causes
- The learner is not identified. In practice, a learner is identified when the course is launched from an LMS (SCORM, xAPI or cmi5), or when the embed URL carries an
sm_userparameter; see Identifying learners for each destination. Authoring tool previews, share links and Review 360 never identify anyone: the AI still answers, but nothing is saved. - The slide is still a draft. Nothing is saved from a slide that is not published.
- The workspace reached its plan’s memory limit. The slide editor then shows a message such as “Variable limit reached” or “Learner limit reached”, and refused writes are recorded in Activity as Memory limit reached.
- The scope cannot be resolved. A value saved with the Course or Module scope needs a slide attached to a course or module; the editor shows “attach the slide first”.
- The key is not configured on the slide. The integration code can only write the keys saved on the slide, so code copied before you changed the captured values sends keys or variables that SlideMind refuses or ignores.
- The course runs on a site that is not in Allowed origins.
- For exchange memory, the AI call failed: the exchange is saved only after a successful AI reply.
Solutions
- Test in the published course launched from your LMS or SCORM Cloud, with the slide published. See Identifying learners.
- Reuse a key already in use, or remove keys you no longer need. See Saving values.
- Attach the slide to a course or module, or use the global scope. See How learner memory works.
- After changing what a slide saves, copy the code again and replace it in your course. See Changing a slide after installation.
- Add the course’s site to Allowed origins. See Allowed websites.
Load into authoring tool returns nothing
Section titled “Load into authoring tool returns nothing”This is the code generated from Memory › Hub with Load into authoring tool.
Causes
- The variable is not defined in the Memory Hub. A key that a slide saves without a Hub definition is listed under Keys found in memory, not in the Hub: add it first with Add to Memory Hub, in the row’s ⋯ menu.
- The variable’s scope is not global. This code only reads global variables.
- Allowed origins is empty or does not list the course’s site. Unlike AI replies, memory reads are refused when the list is empty, and the 24-hour CORS test mode does not apply to them.
- The learner is not identified (preview, share link or Review 360).
- No value is saved yet for this learner. The code only fills the variables that have a saved value.
- The authoring tool variable names in the mapping do not match the variables in your course.
Solutions
- In the Memory Hub, define the variable with the global scope, then generate the code again. A key added with Add to Memory Hub keeps the scope where its values are already stored: if that scope is not global, have the slide that saves it use the global scope. See Memory Hub.
- List every site that runs your course in Allowed origins. See Allowed websites.
- Test in the published course launched from your LMS. See Identifying learners.
- Check the names in Memory → authoring-tool mapping. See Using values in prompts.
The AI’s reply is not what you expect
Section titled “The AI’s reply is not what you expect””Assessment unavailable”, or the error variable is filled
Section titled “”Assessment unavailable”, or the error variable is filled”Causes
The AI did not return every field of the structured result as valid JSON. SlideMind then never invents a score:
- In a Q&A widget with a score or a verdict, the learner sees “Assessment unavailable” (or the label you typed for it).
- With integration code, the return variables stay untouched and the error variable (
…_err) readsassessment unavailable:followed by the missing fields. The answer variable stays empty when its Text field is missing. - In a Chat with return variables in a Storyline Web Object, the learner sees “The response is unavailable. Please try again.”
Typical reasons: too many or too complex fields, a high Temperature, or a Max tokens value too low for the whole JSON reply.
Solutions
- Test the slide in Try it, or a copy of it in the Sandbox. With the authoring tool interface, select Show the structured result after the reply: under Structured result, the fields marked fell back to default are the ones the AI missed. See Sandbox.
- Reduce or simplify the return variables. See Results: plain text or structured.
- Lower Temperature and raise Max tokens in the slide’s AI settings. With some combinations of model and reasoning effort, Temperature is unavailable. See Models and response settings.
The answer variable stays empty, but the return fields are filled
Section titled “The answer variable stays empty, but the return fields are filled”This applies to integration code with structured results.
Causes
- The slide has no Text field. With return fields, the answer variable receives the text of one Text field, never the raw JSON.
- The AI did not return that Text field correctly. The error variable (
…_err) then lists the missing fields.
Solutions
- In the What comes back? step, add a Text field for the message learners read, such as
feedback. On Storyline destinations, choose it in Field sent to the reply variable when the slide has several. - Copy the code again (or download the ready-made Storyline slide again): the field the answer variable receives is written into the code.
See Results: plain text or structured.
Markdown symbols appear in the reply
Section titled “Markdown symbols appear in the reply”Causes
- Plain-text replies were turned off for this activity type.
- The symbols are inside a field of a structured result. Plain-text processing never changes structured JSON.
Solutions
- In Settings › AI & models, under Plain-text AI responses, turn on Strip Markdown in Q&A mode and Strip Markdown in Chat mode (both are on by default). See Models and response settings.
- For structured results, ask for plain text in the AI instructions. See Write the AI instructions.
The reply is cut off
Section titled “The reply is cut off”Cause
Max tokens limits the length of the AI’s reply. Too few tokens may cut an answer short.
Solution
Raise Max tokens in the slide’s AI settings, or ask for shorter replies in the instructions. More tokens can increase cost. See Models and response settings.
The AI replies in the wrong language
Section titled “The AI replies in the wrong language”Cause
The AI replies in the language of your instructions. The widget’s Learner language only changes the buttons, labels and messages of the widget.
Solution
Write the instructions in the language you want, or state the reply language in them. See Write the AI instructions and Appearance and language.
{{variable}} appears as is in the reply
Section titled “{{variable}} appears as is in the reply”A placeholder typed without a vertical bar, such as {{memory.profession}}, reaches the AI as written when it gets no value, and the AI may repeat it. (In an opening message, SlideMind removes it instead.) Its pill in the editor shows a warning.
Causes
- The name is misspelled. A common mistake is a dot instead of an underscore: course and module variables use underscores, such as
{{course_theme}}. The editor warns “never resolves” for these names. - No value arrived and the placeholder was typed by hand without
|, for example a memory value for a learner who is not identified. - A slide variable (a value from your authoring tool) is used on a widget destination. The Rise 360 Code block, the Storyline Web Object and the HTML widget do not send slide variables. The slide editor names these placeholders in a warning under Instructions for the AI.
Solutions
- Insert variables with the chips, or by typing
@in the field, rather than typing their names. Inserted placeholders disappear when they get no value. - Click the pill that shows a warning, then Apply. To show a text instead, type it under If empty, show, for example “a professional”.
- On a widget destination, remove slide variables from the instructions or give them a fallback.
- In the Sandbox, select Preview the prompt only: Prompt sent to the AI lists Variables missing, Fallbacks used and Naming warnings.
See Variables in prompts.
Setup and integration
Section titled “Setup and integration”A model is no longer available, or the provider key is invalid
Section titled “A model is no longer available, or the provider key is invalid”Causes
- With your own API keys, the provider no longer offers the slide’s model. The model picker shows “This saved model is no longer available and will not be replaced automatically.” Learners get an error until you choose another model.
- The provider rejected the key: Provider keys shows “Provider rejected this key.”, and the Overview page can show that the key failed its last test or that your default provider has no API key.
- With SlideMind Credits, a model withdrawn from the catalogue shows “No longer offered.” Another model answers learners until you choose one.
Solutions
- Choose another model for the slide, or another Default model in Settings › AI & models. See Models and response settings.
- In Settings › AI & models › Provider keys, select Test next to the key. If the provider rejects it, save a new key. A course-specific key is managed from the course’s API key card. See Your own provider keys.
An import is refused
Section titled “An import is refused”Causes
- The file uses an old export format: “This file uses a retired export format. Export the items again to get a current file.”
- The file is too large: “Import files are limited to 25 MB.”
- The file is not a valid JSON file, or contains nothing that can be imported at this place.
- The import would go past your plan: “This import creates more items than your plan allows.”, “Custom templates are not included in your plan.” or “The import would exceed the plan’s pages of reference documents.”
- A reference document of the file has no text, or is too long:
Reference document "…": The document has no readable textorReference document "…": A document holds at most 1500000 characters.
Solutions
- Export the items again from their workspace to get a current file.
- Export a smaller selection.
- Uncheck some items, or choose Replace its content instead of Import as a copy for items that already exist.
- For reference documents, remove documents you no longer use from Content › Reference documents, or fix the document named in the message in the source workspace and export again.
See Import and export.
A reference document is refused, or the AI doesn’t use it
Section titled “A reference document is refused, or the AI doesn’t use it”Causes
- The file is a scan, is protected by a password, or is saved as an old .doc or .ppt file. The add dialog says why.
- Every page of your plan’s allowance is in use: “Every page of your plan is in use. …”
- The document isn’t linked to the slide’s course, module or the slide itself, or the slide has Use in this slide turned off.
- The slide reads many pages, and the passages found for a question don’t hold the answer.
Solutions
- Follow the message of the add dialog, for example export the PDF again as a text PDF.
- Remove a document you no longer need, or move to a plan with more pages.
- Test the slide in Try it and read Documents read for this reply: it lists what the AI received.
- Link only what the course, module or slide needs.
See Reference documents.
Rise’s Continue button does not unlock
Section titled “Rise’s Continue button does not unlock”Causes
- Set completion requirements is off in the Rise 360 Code block.
- The activity is not finished yet. A Q&A finishes once the learner sees the feedback. A Chat finishes when it reaches its turn limit, or after the first reply when it has no limit.
Solution
Turn on Set completion requirements in the Code block settings. See Articulate Rise 360.
In a Storyline Web Object, Next does not wait on its own: add a trigger that changes the state of Next when the variable ending in _done changes. See Articulate Storyline (Web Object).
A change made in SlideMind does not show in the course
Section titled “A change made in SlideMind does not show in the course”Causes
Some settings are written into the code installed in the course. Changing them in SlideMind has no effect until you install the code again. Typical cases:
- With integration code: the turn limit of a Chat, the return variables, the values read from the authoring tool, the captured values and the variable names.
- With the widget (Rise 360, Storyline Web Object, HTML widget): the activity type, and in a Storyline Web Object, the answer variable name.
The instructions, the model and the widget’s look apply without installing anything again.
Solutions
- Save the slide, copy the code again (or download the folder again), and replace it in your course.
- Publish the course again from your authoring tool and update it in your LMS.
See Changing a slide after installation.
After renaming a slide, the code no longer matches
Section titled “After renaming a slide, the code no longer matches”Cause
The generated variable names are built from the slide number and title. When you rename the slide, the names in newly copied code follow the new title, unless you typed your own names in the editor. Memory keys do not change: once the slide is saved, they stay stable.
Solutions
- Keep the old names: type them in the Learner question and AI answer fields under Storyline variables (Integration variables in the other authoring tools). Reset to the generated name brings back the generated one.
- Or rename the variables in your authoring tool to match the new code.
See Changing a slide after installation.
The Storyline Web Object variables do not update
Section titled “The Storyline Web Object variables do not update”Causes
- The Storyline variables do not exist, or their names differ. Every variable is optional, so Storyline ignores a name it does not have.
- The folder was downloaded before the slide or its answer variable was renamed.
- Your Storyline variables use the field names alone, such as
score. Return fields are written to<answer>_<field>, such asaiResp_s2_quiz_score: the slide editor shows the full name under each field. - The AI’s result was not valid, so the return variables are left untouched and the variable ending in
_erris filled.
Solutions
- Compare your Storyline variables with the Storyline variables group in the editor, name by name.
- Select Download the folder (.zip) again, then replace the Web Object in Storyline (Insert › Web Object) and publish the course again.
See Articulate Storyline (Web Object).
Messages
Section titled “Messages”Messages learners and authors see
Section titled “Messages learners and authors see”| Message | Where | Likely cause | What to do |
|---|---|---|---|
| ”Configuration not found.” | Widget | The slide is a draft, archived or deleted, or the code is incomplete | Publish the slide, or copy the code again |
| ”This widget is not available.” | Widget | The workspace is suspended or pending deletion | Restore the workspace, or contact support |
| ”The assistant is loading. One moment, please.” | Widget | Many learners at the same moment | Nothing: the page reloads itself |
| ”The AI assistant is temporarily unavailable. Please try again later or contact your course provider.” | Widget, during the activity | Credits exhausted, fair-use limit reached, no AI connected, model not available with SlideMind Credits, SlideMind Credits unavailable for the workspace, or inactive workspace | Check Overview, add credits, connect an AI, or wait for the fair-use count to start again |
| ”Too many requests right now. Please try again in a moment.” | Widget | Still busy after the automatic retries | Try again a little later |
| ”Network error. Please try again.” | Widget | The browser got no answer from SlideMind | Check the connection and any firewall |
| ”Something went wrong. Please try again.” | Widget | AI provider error, rejected key, withdrawn model, or another error | Check Activity, the key and the model |
| ”The response is unavailable. Please try again.” | Widget, Chat with return variables | The reply field of the result was not valid | See Assessment unavailable |
| ”Assessment unavailable” | Widget (Q&A with score or verdict), Sandbox, Try it | The score or verdict was not returned as valid JSON | See Assessment unavailable |
assessment unavailable: followed by field names | Error variable (…_err) | The listed fields were missing or invalid | Same as above |
SlideMind error (code) | Error variable (…_err) | The call failed | See SlideMind error codes |
| ”No AI is connected to this workspace yet” | Try it, Sandbox | No SlideMind Credits and no provider key | Select Set up AI |
| ”Too many tests in a row. Wait a minute, then try again.” | Try it | Many tests close together | Wait a minute |
| ”…its memory writes will be refused. The AI still answers learners.” | Slide editor, Discovery plan | The slide adds memory keys beyond the plan’s limit | Reuse a key already in use, or upgrade |
| ”Variable limit reached” or “Learner limit reached” | Slide editor, Discovery plan | The workspace’s memory limit is reached | Reuse keys, or upgrade |
| ”This slide is not published yet” | Slide editor, installation step | The slide is a draft | Select Publish |
| ”Provider rejected this key.” | Settings › AI & models › Provider keys | The provider refused the key | Save a valid key, then Test |
| ”This saved model is no longer available and will not be replaced automatically.” | Model picker (your own API keys) | The provider withdrew the model | Choose another model |
| ”No longer offered.” | Model picker (SlideMind Credits) | The model left the catalogue; another model answers | Choose another model |
| ”This file uses a retired export format. Export the items again to get a current file.” | Import from a file | Old export format | Export the items again |
| ”Import files are limited to 25 MB.” | Import from a file | The file is too large | Export a smaller selection |
| ”The file exceeds the 25 MiB import limit.” | Settings › Data & privacy, workspace import | The file is too large | Export fewer sections |
| ”This import creates more items than your plan allows.” | Import from a file | Plan limit | Uncheck items, or replace existing ones |
The messages in the widget’s frame before it loads (“Configuration not found.”, “This widget is not available.” and “The assistant is loading. One moment, please.”) are always in English. The other widget messages follow the Learner language. In French, learners see:
| English | French |
|---|---|
| The AI assistant is temporarily unavailable. Please try again later or contact your course provider. | L’assistant IA est temporairement indisponible. Réessayez plus tard ou communiquez avec le responsable de votre formation. |
| Too many requests right now. Please try again in a moment. | Trop de demandes en ce moment. Réessayez dans un instant. |
| Network error. Please try again. | Erreur réseau. Veuillez réessayer. |
| The response is unavailable. Please try again. | La réponse est indisponible. Veuillez réessayer. |
| Something went wrong. Please try again. | Une erreur s’est produite. Veuillez réessayer. |
| Assessment unavailable | Évaluation indisponible |
SlideMind error codes
Section titled “SlideMind error codes”With integration code, a failed call writes SlideMind error (code) to the error variable. The code is the status of the answer the browser received.
| Code | What it means | What to do |
|---|---|---|
| 0 | The browser could not read any answer: the course runs on a site that is not in Allowed origins, the network or a firewall blocked the request, or (Storyline code) the request got no answer within the time limit | Add the site to Allowed origins; check the connection |
| 400 | The request was invalid: the learner’s message is empty or too long, or the slide’s Reasoning effort is not supported by its provider | Make sure the learner’s text reaches the variable; choose another reasoning effort |
| 402 | SlideMind Credits are exhausted | Buy credits with Add credits in Account › Billing |
| 403 | The slide is not published, the workspace is suspended or pending deletion, or the slide’s model is not available with SlideMind Credits on your plan | Publish the slide, restore the workspace, or choose another model |
| 404 | No slide matches the code: the slide was deleted, or the code was changed | Copy the code again from the slide |
| 413 | The request was too large, for example a long Chat conversation with long messages | Set a turn limit in the Conversation step, or ask for shorter replies in the instructions |
| 429 | Still too many requests after the automatic retries, or the workspace reached its fair-use limit and learner chats are paused until the 1st of the month (UTC) | Try again later; to raise the limit, select Contact support in Activity |
| 500 | No AI is connected for the slide’s provider (your own API keys mode without a key), or an unexpected server error | Add a provider key or turn on SlideMind Credits |
| 502 | The AI provider returned an error, did not answer in time, or sent an unreadable reply (for example, a rejected key or a withdrawn model) | Test the key, check the model, look in Activity |
| 503 | AI through SlideMind Credits cannot run for this workspace right now, or the owner’s subscription is paused | If the subscription is paused, wait for the end of the pause or select Resume now in Account › Billing (see Pause your subscription). Otherwise, contact support. |
Browser console messages
Section titled “Browser console messages”The integration code writes these messages to the browser console. They help an integrator see why nothing happened.
| Message | Written by | Meaning |
|---|---|---|
SlideMind: the learner's message is empty | Chat code | The learner’s variable was empty when the trigger ran |
SlideMind: this conversation has reached its turn limit | Chat code | The conversation already used every turn; the ended variable (ending in _done) is set to true. To start over, set the history variable (ending in _history) to an empty text |
SlideMind learner identifier is missing | Capture code, Memory Hub code (Save to memory, Load into authoring tool) | No learner is identified, so nothing is saved or read |
SlideMind capture failed followed by a code | Capture code, Memory Hub Save to memory code | SlideMind refused the values (unpublished slide, site not allowed, key not configured on the slide, scope that cannot be resolved, or plan limit) |
SlideMind memory read failed (code) | Load into authoring tool code | SlideMind refused the read (see Load into authoring tool returns nothing) |