Grading Quizzes

Sensei allows teachers to manually grade a Lesson. To access this area, go to Sensei > Grading.

On the Grading page, you are presented with a table containing any ungraded quizzes that have been submitted for manual grading.

The grading table displays:

  • Learner’s name
  • Which course and lesson for which they submitted a quiz
  • Date and time of submission
  • Grading status (Ungraded, Graded, In Progress)
  • Learner’s grade for that quiz
  • Button for grading the quiz or reviewing an existing grade

Filtering Quizzes

You can use links at the top of the grading page to display all submitted quizzes, or only those that are graded, ungraded or in progress.

You can also select a specific course and lesson if you only want to grade quizzes for a single lesson at a time. After selecting a course and lesson, click the ‘Reset Filter’ button to display all quizzes again.

If you want to grade quizzes for a specific learner, you can use the search box to search for users. After searching for a user, you need to clear the search box and submit an empty search to display all users again.

Grading a Quiz

To grade a quiz, click the ‘Grade quiz’ button on the quiz you want to grade. If you already graded the quiz, the button displays ‘Review Grade’ instead.

The Quiz answers are loaded, along with any existing auto-graded questions. From here you can manually grade each Questions answer, and assign a grade to the whole Quiz.

You also have access to:

  • Add notes to answers. You can use this to provide feedback to learners about why they received the grade.
  • Assign a specific grade to the answer. When creating quizzes, you can specify a total grade that each question is worth. When grading, you can specify a grade that is no more than the question’s total grade.

When a learner views their graded quiz, they see which questions they got right/wrong as well as their grade per question and their total grade for the entire quiz. They can also view answer notes that were entered.

Grading UI
Grading a Learners Quiz

Quiz Settings Flowchart

This chart shows the behavior of Sensei quizzes when the various settings are enabled/disabled:


Note that answer feedback is only displayed if you:

  1. Pass the quiz; or
  2. The ‘reset quiz’ button is disabled.


Using Mathematics in Quizzes

You can use LaTeX notation and the Beautiful Math component of Jetpack to include complex mathematical and scientific expressions in your quizzes. 

Once you have installed Jetpack and activated the Beautiful Math module, you can enter any LaTeX code in your questions/answers, with ‘$latex’ before it and ‘$’ after it (as described here), and it will be converted to an image for display in your quizzes.

What the course author enters:


What the learner sees:



Adding Quizzes

No matter what questions you might have about quizzes, we have the answers!

Create a Quiz

When creating a new lesson, you will find the Quiz Settings panel below the main content area, with a message indicating that there is no quiz for this lesson (yet!). You will need to save the lesson before you will be able to build the quiz:

Quiz Settings metabox

There are three methods available for adding questions to a quiz on the Edit Lesson screen. You can add a new question, add an existing question, or add a category question(s). Please note that category questions will not appear unless you already have created at least one category under Questions > Categories in your dashboard.

Add a New Question

Please see the Question Bank documentation for more information on how to add new questions. It’s worth noting that when a new question is added to a quiz, that question also gets added to the Question Bank so that it can be reused in other quizzes:

Add new question to lesson

Add an Existing Question

This option allows you to select one or more existing questions from the Question Bank and insert them in your quiz.

You can search for a question, or filter by question type and question categories, and questions that have/haven’t already been used in a quiz.


The panel displays 10 questions per page. Remember that selections are not preserved between pages, so you must select and add questions from one page before moving to the next.

Add a Category Question(s)

This option provides full Question Bank functionality, allowing you to insert a random selection of questions from any question category.

Select a category and a number of questions to display, and click Add Questions.


Questions appear as a single entry in your question list, as shown:


You can add multiple groups of category questions if you want to include questions from more than one category in the same quiz.


You can also use a mixture of Category Questions and Existing Questions if you want to use randomly selected questions, and you have certain questions that need to be included in the quiz each time.


Using the Existing Questions and Category Questions options, it is technically possible to add multiple instances of the same question, but no questions are duplicated on the front-end of your site.

File Uploads

Students can also upload files for quiz questions. This gives students the ability to create artwork, documents, video or other types of files as part of a test or to submit as homework.

File types allowed are dictated by WordPress. More at: Uploading Files – Types.

Remove Questions from a Quiz

To remove a question or group of questions from a quiz, click ‘Remove’ next to the question or group of questions.

Removing a question from a quiz doesn’t delete it from the Question Bank. To delete a question, you need to go to Questions > All Questions and click the ‘Trash’ link on the question you want to delete.

Quiz Settings

Once you’ve added questions to your quiz, you can customize settings for the quiz in the Quiz Settings panel:


Pass required to complete lesson
Learners need to achieve a specified passmark before the lesson is completed.

If this is not ticked, the passmark is automatically set to 0, and the learner can complete the lesson without passing the quiz.

Quiz passmark percentage
The score needed to pass this quiz. This setting is only visible if “Pass required” is ticked.

Number of questions to show
You can optionally choose to limit how many of this quiz’s questions are displayed each time the quiz is taken.

You can also reset all quizzes to display all questions by going to Sensei > Updates and running the ‘Set all quizzes to show all questions’ update.

Randomize question order
Displays the quizzes questions in different order each time.

Grade quiz automatically
If your quiz contains only multiple choice, gap fill* or true/false questions, you can have it graded automatically as soon as the learner submits the quiz. This also displays any answer feedback for each question. See Question Bank for more information.

Allow user to retake the quiz
This adds a ‘Reset Quiz’ button below the quiz, so learners can take the quiz again if needed.

When auto-grading a gap-fill question, the case and leading/trailing spaces are ignored. For example, the following question accepts both “silver” and “Silver” as the correct answer, and also ignores any spaces before and after the given answer.


If there is more than one possible answer, or you want to account for common spelling mistakes, you can also add the correct answer as a regular expression.

The most common use for this would simply be listing all possible correct answers (separated by a pipe “|” ) e.g:


Question Bank

Questions can be added independently of quizzes, so questions can be reused in multiple quizzes, and a quiz can contain randomly selected questions from any question category.

Adding Questions to the Question Bank

To add a question to the question bank, go to Questions > Add New.


To add a question:

  1. Enter your question in the Question field.
  2. Select the question type from the drop down.
  3. Enter the relevant answer(s) – exact options depend on the question type you selected.
  4. Enter the total grade for the question – this can be a numerical value greater than or equal to zero.
  5. Select Add Question to complete that question and add another if you like.

Zero-grade questions

Questions can be assigned a grade value of zero.

Questions with no grade are skipped during auto-grading, so you can include open-ended questions in an auto-graded quiz.

Question Types

You can choose from the following question type drop down when adding a question to a quiz:

  • Multiple Choice
  • True/False
  • Gap Fill
  • Multi Line
  • Single Line
  • File Upload

Note: From v1.5 the Essay Paste question type has been removed because it was the same as the ‘Multi-Line’ question type. Any existing Essay Paste questions are converted to Multi-Line questions when updating to v1.5.+

You can add more than one correct answer for a multiple choice question.


If you add more than one correct answer, the learner is able to select multiple answers when viewing the question, and they need to select all correct answers to receive a correct score.

Question Categories

You can also assign your question to a question category to make it easier to add relevant questions to each quiz.

You can select an existing question category, or add a new question category, in the Question Categories panel.


You can also view all question categories and add new categories via Questions > Categories

Adding media to a Question

You can upload a media file to any question: Images, audio files and video files are displayed inline within the question, and any other type of file will be displayed as a link.

The media item’s Title and Description, if present, is displayed below the media.

By default, images in questions use the Medium size setting, as defined in Settings > Media. If you need to change the size, you can use the following filter:

The $size = large; parameter in the filter above can be changed for any of the WordPress default image sizes that can be found here.

Adding Auto Answer Feedback

You can add Answer Feedback to any questions that are auto-graded, i.e., Multiple Choice and True/False.


This feedback is shown to learners after they submit a quiz that is set to automatic grading.

If the quiz is set to manual grading, you are able to customize the answer feedback when grading the quiz.