LifterLMS Course Categories, Tags, Tracks and Difficulty Levels
A practical plan for organizing LifterLMS courses with categories, tags, tracks and difficulty levels: what each one is for, where it shows up, how…
Read articleBuilding a quiz is the easy part. The questions that reach your support inbox come later: why is this attempt "Pending Review"? Which attempt counts? Why is the lesson still locked? How do I give a student another go?
This guide explains LifterLMS quiz grading from the moment a student clicks start to the moment an instructor saves a review. It is for course owners, instructors and support staff who manage quiz results day to day. Labels and behaviour were checked against LifterLMS 10.3.
If you are still setting a quiz up, our guide to creating quizzes in LifterLMS covers the settings. For the question types and how each is graded, see LifterLMS question types.
Every time a student starts a quiz, LifterLMS creates an attempt record with a number (Attempt #1, #2 and so on), the questions served, the answers given, timestamps and a status. There are four statuses:
| Status | Meaning | What happens next |
|---|---|---|
| Incomplete | Started but not submitted | The student finishes it, resumes it if allowed, or it stays incomplete |
| Pending Review | Submitted, but at least one answer needs an instructor | No pass or fail until every waiting answer is graded |
| Fail | Graded below the Passing Percentage | The student can retake if attempts remain |
| Pass | Graded at or above the passing percentage | The lesson can complete; Disable Retake can lock the quiz |
When an attempt is submitted, LifterLMS checks every question. If all of them could be graded automatically, it calculates the grade straight away: points earned divided by points available, rounded to two decimals, then compared with the passing percentage. If any answer is waiting for manual review, the attempt is set to Pending Review and gets no grade yet.
A student may take a quiz several times, but only one attempt feeds their grades: the best one. LifterLMS picks the graded attempt with the highest grade, using the most recently updated attempt to break ties. Incomplete and Pending Review attempts are ignored until they are graded.
That best attempt becomes the lesson's grade, and lesson grades roll up into the course grade, weighted by each lesson's Lesson Weight. Our article on LifterLMS grades explains that calculation in full.
Two consequences surprise people:
A quiz completes its lesson when an attempt is submitted, subject to the lesson's Require Passing Grade on Quiz setting:
This is why manual grading speed matters on courses that require passes. Every hour an attempt sits in Pending Review is an hour the student cannot move on. If you use prerequisites to lock the next lesson, a student may be stuck until someone reviews their answer.
The official LifterLMS guide to grading and reviewing quizzes shows these screens with screenshots. Instructors and admins find attempts under LifterLMS > Reporting > Quizzes. Pick a quiz and open the Attempts tab. Filter by status to see the attempts waiting for you.
The attempt screen shows the Grade, Correct answers, Points earned, Status, Start Date, End Date and Time Elapsed, followed by every answer.
When you save, LifterLMS recalculates the attempt. An answer that earns at least half of its points is marked correct; less than half, incorrect. If no answers are left waiting, the attempt gets its grade and a Pass or Fail status, and the normal pass, fail and completion actions run. That means the lesson can now complete, and engagements such as a certificate on Student passes a quiz are triggered.
You can also save remarks without points. The attempt then stays in Pending Review, which is useful when two people share the marking.
Under LifterLMS > Settings > Notifications, the Quizzes: Quiz Graded notification tells students a review has been saved. Quizzes: Quiz Passed and Quizzes: Quiz Failed cover automatic results. Turn on the graded notification on any course with manually graded questions; otherwise students have no reason to come back and look.
After submitting, the student lands on the quiz results. The heading reads "Attempt #2 Results" (with the right number), followed by a chart of the grade with the pass or fail status, "Correct Answers: 7 / 10", the date and the total time.
Below that is the list of questions. Each one can be expanded to show the student's answer, your remarks, and the Result Clarifications written for that question. If Show Correct Answers is enabled on the quiz, students also see the right answer for questions they got wrong.
When a student has more than one attempt, a View Previous Attempts section lists them as "Attempt #1 - 65% (Fail)" and so on, so they can compare. Grades also appear under My Grades on the student dashboard.
If a quiz has Can be resumed switched on (it is only available when there is no time limit), a student who leaves mid-quiz can return and continue the same attempt. Resuming only applies to the student's latest attempt and only while it is still incomplete. By default the window is 24 hours from when the attempt started.
Two admin controls deal with leftovers:
A developer can change the 24-hour window with a filter:
add_filter( 'llms_quiz_attempt_resume_time_period', 'llmsx_quiz_resume_hours', 10, 2 );
function llmsx_quiz_resume_hours( $hours, $attempt ) {
// Give students three days to come back to an unfinished attempt.
return 72;
}
LifterLMS has no single "reset quiz" button for a student, but you have three tools:
Be careful with deletions in regulated training. Deleted attempts cannot be recovered, and an auditor may expect to see every attempt, including failed ones. Export or screenshot results before you remove anything.
Since LifterLMS 10.2 the REST API includes quiz attempts. That makes it possible to build a marking queue in another tool or to automate clean-ups. With an API key tied to a user who can view reports and edit the quiz:
GET /wp-json/llms/v1/quiz-attempts?status=pending lists attempts waiting for review; filter further with quiz or student.POST /wp-json/llms/v1/quiz-attempts/{id}/grade grades an attempt.DELETE /wp-json/llms/v1/quiz-attempts/{id} deletes one.The grade route takes a list of questions, each with an id and an earned points value, a remarks value, or both:
curl -X POST \
"https://example.com/wp-json/llms/v1/quiz-attempts/789/grade" \
-u "ck_your_key:cs_your_secret" \
-H "Content-Type: application/json" \
-d '{"questions":[{"id":321,"earned":3,"remarks":"Good reasoning, but cite the regulation."}]}'
Remarks-only submissions leave the attempt pending, exactly like the admin screen. The quiz-attempt.completed and quiz-attempt.graded webhook topics let another system know when attempts arrive or are graded. Our REST API and webhooks introduction covers keys and signatures.
The highest. The best graded attempt is the quiz grade, regardless of how many lower attempts follow it.
Yes, on questions they grade manually. They enter any number of points up to the question's value. Automatically graded questions are all or nothing.
Yes, unless Disable Retake is on. If it is, delete the passing attempt or switch the setting off temporarily.
On the quiz page under View Previous Attempts, and in My Grades on the student dashboard.
Agree a marking turnaround for any quiz with manually graded questions, switch on the Quiz Graded notification, and check each lesson's Require Passing Grade on Quiz setting against what you actually want to happen when a student fails.
If your team grades at volume, needs results in another system, or needs an audit trail for accredited training, the REST endpoints above make a custom marking workflow possible. Our LifterLMS development team builds these, and you can tell us how you grade today.
A practical plan for organizing LifterLMS courses with categories, tags, tracks and difficulty levels: what each one is for, where it shows up, how…
Read article
Every LifterLMS quiz question type explained: what it measures, how it is graded, the pitfalls of each, and which ones need the Advanced Quizzes…
Read article
Add extra questions such as job role, company or employee number to LifterLMS checkout, registration and account forms, with the Custom Fields add-on…
Read articleSkip the trial and error. Get specialist LifterLMS help and ship faster.