LifterLMS PHP Version Compatibility: Upgrading PHP Safely
Which PHP version LifterLMS needs, which one you should actually run, and a step-by-step way to upgrade PHP on a course site without breaking…
Read articleWhen a LifterLMS quiz is not working, students notice immediately and they write to you. The quiz shows a blank area, the spinner never stops on "Loading Question...", an answer disappears, the timer submits an unfinished attempt, or the grade is not what anyone expected.
This guide is for course owners and developers who need to diagnose that quickly. It groups quiz problems by symptom, quotes the messages LifterLMS shows, explains the setting or behaviour behind each one, and gives the fix. It assumes you know how to build a quiz. If not, start with how to create quizzes in LifterLMS.
Most "the quiz is broken" reports turn out to be access rules working as designed. Check these in order.
LifterLMS only lets enrolled students take a quiz, and that includes administrators. The LifterLMS documentation has an article titled "Help, my brand new quiz is blank when I try to take it!" for exactly this reason. Enroll a test student and test as that student in a private browser window.
A quiz must be switched to Published in the course builder. If it has no questions, students see "Unable to start quiz because the quiz does not contain any questions."
If the lesson has Enable Minimum Time switched on, starting the quiz before that time has passed shows "You must spend the required minimum time on the lesson before taking the quiz." Students need to stay on the lesson until the timer finishes. Our guide to lesson time tracking explains how that time is counted.
With Limit Attempts on, a student who has used them all sees "You've reached the maximum number of attempts for this quiz." With Disable Retake on, the quiz closes for anyone who has passed. Both are covered under attempts below.
A quiz inherits its lesson's drip date and prerequisites. If the lesson is not available yet, neither is the quiz.
LifterLMS quizzes run in the browser. Starting an attempt, loading each question and recording each answer are separate background requests to WordPress's admin-ajax.php. When one of those requests fails, students see "An unknown error occurred. Please try again." or a loader that never finishes. Server-side failures show messages such as "There was an error recording your answer. Please return to the lesson and begin again."
The causes are usually outside LifterLMS:
admin-ajax.php will interrupt the quiz partway through. In the browser's Network tab a blocked request shows as 403 or 429."You must select an answer to continue." is not an error. LifterLMS requires an answer to each question before moving on.
The Time Limit setting adds a countdown, labelled "Time Remaining". When it reaches zero, the quiz script completes the attempt with whatever has been answered. Three surprises come up repeatedly.
With Can be resumed on, a student can click "Save & Exit Quiz" and pick up later. An attempt can only be resumed when all of these are true:
If a student starts a new attempt instead of resuming, the earlier resumable attempt is ended. On the attempt's reporting screen, administrators also have a Disable Resume Attempt button.
If your learners need longer than a day, a developer can change the window with the llms_quiz_attempt_resume_time_period filter, which takes a number of hours. Add it to a small custom plugin, not your theme:
<?php
/**
* Plugin Name: LLMSX Quiz Resume Window
*/
add_filter( 'llms_quiz_attempt_resume_time_period', 'llmsx_quiz_resume_hours', 10, 2 );
/**
* Allow incomplete quiz attempts to be resumed for 72 hours.
*
* @param int $hours Resume window in hours. Default 24.
* @param LLMS_Quiz_Attempt $attempt The attempt being checked.
* @return int
*/
function llmsx_quiz_resume_hours( $hours, $attempt ) {
return 72;
}
Attempt limits interact with other settings in ways that strand students.
To hand an attempt back, go to LifterLMS > Reporting > Quizzes, open the quiz, open the attempt and click Delete Attempt. Deleting is permanent, so note the grade first if you need a record.
Most grading complaints are the arithmetic working exactly as configured. These are the ones worth knowing.
| Surprise | Explanation |
|---|---|
| "I got 4 out of 5 right and failed" | The grade is points earned divided by points available. If questions carry different points, four correct answers can be under the Passing Percentage. |
| Multiple-answer question marked wrong | With Multiple Correct Choices, the student must select every correct choice and no wrong ones to earn the points. There is no partial credit in core. |
| Attempt shows "Pending Review" | The quiz contains a question that needs manual grading, from the Advanced Quizzes add-on. The attempt has no pass or fail until an instructor reviews it. |
| Editing a question did not change old grades | Each attempt stores its questions, points and results when it is taken. Changing a question's points or correct answer later does not regrade earlier attempts. |
| Course grade does not match the quiz grade | The course grade averages lesson grades using each lesson's weight, and uses the student's best attempt for each quiz. |
The edited-question case catches many course owners. If you fix a mistake in an answer key after students have taken the quiz, existing attempts keep their original result. The fair options are to delete the affected attempts so students can retake, or to leave a review note explaining the correction. Our guide to quiz attempts, grading and results covers reviews in detail.
Because you are not enrolled. LifterLMS requires enrollment in the course to take its quizzes, even for administrators. Enroll yourself or use a test student account.
Edit their user profile and tick "Allow unlimited quiz time for quizzes that have a time limit set" in the LifterLMS Profile section. Core LifterLMS does not offer a per-student extension of a set number of minutes.
Delete attempts individually from the attempt screen in Reporting. Each deleted attempt is removed permanently and frees up one attempt if the quiz is limited.
A background request failed. The usual causes are page caching, a firewall blocking admin-ajax.php, a JavaScript conflict or an expired login. Check the browser's Network tab to see which request failed.
Start with the checklist above. Access rules and caching explain most quiz problems, and both can be confirmed in minutes with a test student account. For assessment rules the settings cannot express, such as partial credit, per-student time extensions or regrading after an answer key change, the solution is custom development.
Our LifterLMS support team diagnoses quiz failures on a staging copy of your site, and our LifterLMS customization service builds the grading logic core does not include. Tell us what your students are seeing.
Which PHP version LifterLMS needs, which one you should actually run, and a step-by-step way to upgrade PHP on a course site without breaking…
Read article
What each common LifterLMS checkout error message means, why the checkout sometimes just reloads, how to read gateway logs and order notes, and how…
Read article
A calm, step-by-step way to recover a LifterLMS site from a white screen or “critical error”: get back in with recovery mode or WP-CLI, read the…
Read articleSkip the trial and error. Get specialist LifterLMS help and ship faster.