The Quiz field for Gravity Forms allows you to quickly create quizzes that are automatically graded or scored when the form is submitted. It is available under the Advanced Fields section within the form editor if you have the Quiz Add-On installed. For more information on setting up your Quiz field please review this article, and the other user guides for the Quiz Add-On.

Quiz Field Icon

Quiz field as displayed in the Field Library

Quiz Field in Form Editor

Quiz field as displayed in the Form Editor.

Common Settings

For a description of each of the common field settings, refer to this article. Below you will find descriptions of specialty settings that are particular to this field.

General Settings

Quiz General Settings
Reference Image - Quiz Add-on General Settings Part 2
Quiz QuestionEnter your question here.
DescriptionDisplays on your form to provide some additional direction to the user.
Quiz Field TypeSelect between allowing a single choice using radio buttons or a drop down, or allowing multiple choices using a checkbox field type
Quiz AnswersAdd answers for this quiz question. Clicking the + to the right of a choice row to add more answer slots, or delete the current rows by clicking x.
Select which answer, or answers, are correct by clicking the gray checkmark (turning it green).You must identify at least one correct answer for each Quiz field.
Weighted Score By default, a correct answer counts as 1, and an incorrect answer as 0 towards the overall Quiz score. When Weighted Score is selected, a box with a ‘0’ will show up to the right of each choice. Here you can define what the contribution to the quiz score will be for each answer when chosen. See note 1.
Bulk Add / Predefined ChoicesCustomize the predefined choices or paste your own list of choices to add. This article covers this in more depth.
Randomize Quiz AnswersRandomize the order in which the answers are displayed to the user. This setting affects only the quiz front-end. It will not affect the order of the results.
Enable Answer ExplanationThis option enables you to provide an explanation of the answer. See note 2.


  1. For detailed examples of weighted quiz scoring and how it is calculated, refer to this article.
  2. The Answer Explanation is shown to the user if Instant Feedback is enabled in the form level Quiz settings (also note limitations of Instant Feedback). The explanation will be shown immediately after answering each question. You can also display the explanation with the quiz results on your form’s confirmations or notifications via merge tags (i.e. {quiz:id=1} or {all_quiz_results}),

Merge Tags

You can view quiz-specific merge tags in this article.

For more information on the use of merge tags, refer to these articles.

The following filters were added to Gravity Forms in support of the quiz field: