LifterLMS Quiz Grading: Attempts, Reviews, Results and Resets

How LifterLMS records quiz attempts, which attempt counts, how to manually grade answers with partial credit, what students see on the results screen, and how to reset or clear attempts.

  • Add as a preferred source on Google
Illustration for “LifterLMS Quiz Grading: Attempts, Reviews, Results and Resets”

Building 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.

How LifterLMS quiz grading works

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:

StatusMeaningWhat happens next
IncompleteStarted but not submittedThe student finishes it, resumes it if allowed, or it stays incomplete
Pending ReviewSubmitted, but at least one answer needs an instructorNo pass or fail until every waiting answer is graded
FailGraded below the Passing PercentageThe student can retake if attempts remain
PassGraded at or above the passing percentageThe 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.

Which attempt counts

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 worse retake never lowers the grade. If a student scores 90 and then 60, their quiz grade stays 90.
  • Deleting the best attempt does. If you delete the 90, the 60 becomes the best attempt.

How quiz results affect lesson completion

A quiz completes its lesson when an attempt is submitted, subject to the lesson's Require Passing Grade on Quiz setting:

  • Setting off: any submitted attempt completes the lesson, including a failed attempt or one that is still Pending Review.
  • Setting on: only a passing attempt completes the lesson. A Pending Review attempt leaves the lesson incomplete until an instructor grades it and the result is a pass.

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.

Review and manually grade an attempt

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.

Grading step by step

  1. Click Start a Review. A Remarks to Student box appears under every answer, plus a points field on manually graded questions.
  2. For each answer that needs grading, enter the points earned. You can award any whole number up to the question's points, so partial credit is possible.
  3. Add a remark wherever feedback helps, including on automatically graded questions. Remarks can be several lines long.
  4. Click Save Review.

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.

Notify students when their quiz is graded

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.

What students see on the results screen

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.

Resumable attempts

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:

  • Disable Resume Attempt on a single attempt ends it as it stands and grades what was answered.
  • Clear resumable attempts at the foot of a quiz's attempts list does the same for every resumable attempt on that quiz. Use it before you change a quiz's questions, so nobody resumes into a quiz that no longer matches.

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;
}

Reset attempts and give a student another chance

LifterLMS has no single "reset quiz" button for a student, but you have three tools:

  1. Delete Attempt. Open the attempt and click Delete Attempt. The record is removed permanently, its grade no longer counts, and if the quiz uses Limit Attempts the student gets that attempt back. Deleting all of a student's attempts on a quiz is the closest thing to a full reset.
  2. Raise the attempt limit. Increasing Limit Attempts on the quiz gives every student more tries. Simple, but it applies to everyone.
  3. Re-grade instead of deleting. If a question was wrong, for example the correct answer was marked incorrectly, fix the question and review affected attempts. Deleting results to cover a mistake in the quiz throws away evidence you may need later.

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.

Grading and resetting through the REST API

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.

Troubleshooting common grading problems

  • "The student passed but the lesson is not complete." If the pass came from a manual review, completion runs when the review is saved, so check that the review was saved rather than just started. If the lesson is still incomplete, use Mark Complete on the student's course screen in reporting.
  • "The grade is lower than the student expected." Look at multiple-answer questions first. They are all or nothing when graded automatically.
  • "An attempt is stuck in Pending Review." One question, often a manually graded one hidden among automatic ones, still has no points. Open the attempt, enter points for it, and save.
  • "The quiz shows the wrong number of remaining attempts." Every attempt counts towards the limit, including abandoned incomplete ones. Delete the abandoned attempt to give it back.
  • "The course grade did not change after a retake." The new attempt was not better than the best one, so the best attempt still counts.

Frequently asked questions

Does LifterLMS use the highest or the latest quiz score?

The highest. The best graded attempt is the quiz grade, regardless of how many lower attempts follow it.

Can instructors give partial credit?

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.

Can I let a student retake a quiz they have already passed?

Yes, unless Disable Retake is on. If it is, delete the passing attempt or switch the setting off temporarily.

Where do students see their quiz history?

On the quiz page under View Previous Attempts, and in My Grades on the student dashboard.

Next steps

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.

Add LifterLMS Expert to your preferred sources

Add lifterlmsexpert.com as a preferred source on Google, or open this article in your AI assistant to use it as a source.

  • Add as a preferred source on Google
Free consultation

Prefer expert help over DIY?

Skip the trial and error. Get specialist LifterLMS help and ship faster.

Talk to a LifterLMS Expert Explore our services

Replies within one business day