Gravity Forms Quiz - WordPress Plugin
The plugin is a valuable addition to the Gravity Forms ecosystem, enabling users to seamlessly incorporate quizzes into their WordPress websites with ease. By leveraging the plugins features, website owners can create interactive quizzes to engage their audience effectively. The tool is designed to be user-friendly, allowing customization options to match the websites branding effortlessly.

Plugin Features
Offering a plethora of quiz-building functionalities, including various question types, scoring mechanisms, and result calculations, the plugin empowers users to craft diverse and engaging quizzes. With its intuitive interface, users can quickly set up quizzes without the need for extensive technical knowledge. This feature-rich solution caters to the needs of different industries and website types looking to implement interactive quizzes as part of their content strategy.
The plugins seamless integration with Gravity Forms ensures a smooth user experience, allowing users to leverage the robust form-building capabilities alongside quiz functionalities. Through this integration, users can collect quiz responses efficiently and analyze the results to gain valuable insights into user engagement and performance. The flexibility of the plugin enables website owners to create dynamic quizzes that resonate with their target audience and drive meaningful interactions.
Users can enhance the quiz-taking experience by incorporating multimedia elements such as images, videos, and audio into their questions and answers. This versatility enables the creation of visually appealing and interactive quizzes that capture users attention and deliver an immersive experience. Moreover, Gravity Forms Quiz responsive design ensures that quizzes display optimally across various devices, providing a seamless experience for all users, regardless of their preferred device.
By leveraging the advanced features of the plugin, such as conditional logic and quiz timers, users can create personalized quiz experiences that adapt to each participants responses. This level of customization allows website owners to deliver tailored quiz content based on user input, leading to a more engaging and interactive experience. With its robust set of features and seamless integration with Gravity Forms, the plugin serves as a comprehensive solution for incorporating dynamic quizzes into WordPress websites.
Specifications:
| Release date: | 12-07-2019 | |
| Last updated: | 12-06-2025 | |
| Type: | Paid | |
| License: | GPL | |
| Subject: | for Gravity Forms | |
| Compatibility: | W5.x W6.x | |
| Includes: | Plugin | |
| Language packs: |
|
|
| Developer: | Gravity Forms | |
| Rating: | ||
Share with your friends!
Guide to Setting Up and Using Gravity Forms Quiz
Gravity Forms Quiz is not just for adding a couple of questions to a form. Inside Gravity Forms, it turns a standard WordPress form into a graded quiz: the visitor answers questions, the plugin calculates the result, displays a confirmation, saves the entry, and shows answer statistics to the administrator. This guide focuses on the actual workflow - from preparing the form to checking the result on the page.
This article does not repeat the product's short description. What matters here is understanding where the Quiz field lives, how the question types differ, when to enable weighted scoring, how to configure Pass/Fail or Letter grading, how to use quiz merge tags in confirmations, and what to check if the result looks wrong.
Gravity Forms Quiz is especially useful when the quiz is part of a form: employee training, knowledge checks after instructions, lead qualification, quick self-assessments, application screening, or interactive content with results saved in the admin panel. If you need a full learning portal with lessons, attempts, certificates, and course progress, this add-on alone may not be enough - we will cover that as well.
How Quiz Fits Into Gravity Forms Logic
The main advantage of the add-on is that it does not create a separate quiz system alongside WordPress. It adds a dedicated Quiz field to the Gravity Forms editor and then relies on the familiar form mechanisms: fields, confirmations, notifications, entries, embedding via block or shortcode, result filtering, and statistics. That is why setup starts not with a separate "quiz builder," but with the form where you add quiz fields.
Once the add-on is installed, the Quiz field appears in the Advanced Fields section of the form editor. Each of these fields usually represents one question. Inside the field, you define the question, answer choices, correct answers, display type, and extra settings such as randomizing answer order, answer explanations, weighted scoring, and for checkboxes, the ability to select all applicable options.
The second level of configuration is not inside the field itself, but in the form settings. After you add at least one quiz field, a Settings - Quiz section appears. It controls the behavior of all quiz fields in that specific form: whether to shuffle the questions themselves, whether to show instant feedback, and whether to calculate the final grade as Pass/Fail or as a Letter grade.
It is important to separate the question level from the form level. The field type, answer choices, and scores are configured in the individual Quiz field. The overall result logic, passing threshold, and confirmation text are configured in the form's Quiz settings. If you mix up these levels, the quiz may still submit, but the administrator will not understand why the participant does not see the expected outcome or why the statistics are calculated differently than expected.
The third level is result output. Gravity Forms Quiz saves submissions as regular entries and also shows a dedicated Quiz Results screen with the number of submissions, average result, percentages, grade frequencies, and a breakdown of answers by question. This is useful for training quizzes and lead forms because you can see not only each user's final result, but also weak points in the questions themselves.
What This Type of Quiz Is Best For
Gravity Forms Quiz works best when the quiz is part of something the user is doing on the site. It is not a standalone LMS, but a form with automated grading. This format is useful when you need to save the submission, send a notification, display a final message, pass the result into related Gravity Forms workflows, or manually review responses in the admin panel.
Knowledge checks after instructions or training
The clearest use case is a short quiz after a training page. For example, a company site publishes instructions for employees, contractors, or customers and adds a form with 8 to 12 questions. The user completes the quiz, sees a percentage or status, and the administrator reviews the results to identify which questions cause the most errors.
In this scenario, required quiz fields, Pass/Fail grading, a clear failure message, and a separate review of statistics after the first submissions are all useful. If the quiz is intended for serious certification, it is better not to enable instant feedback, because the official documentation explicitly positions it for training and lower-stakes scenarios.
Lead qualification or choosing the next step
Quiz can be used for more than just "right or wrong." Weighted scoring lets you assign different point values to different answer choices. That allows the form to evaluate how ready a visitor is for a service, their level of preparation, the priority of the request, or the likely type of issue. After submission, the result can be shown in the confirmation message and saved in the entry for the manager.
What matters here is not presenting the quiz as medical, legal, or financial diagnosis unless the site has the appropriate expertise and approved wording. Gravity Forms Quiz calculates scores according to the rules you set, but it does not validate the logic of your methodology. Responsibility for accurate interpretation remains with the quiz author.
Interactive content for engagement
For content-driven sites, a quiz form can become a lightweight interactive block: a mini quiz related to an article, a skill self-assessment, or a quiz for subscribers. Letter grading, friendly confirmation messages, and explanations of correct answers all fit well here. If the goal is learning rather than assessment, you can enable Instant Feedback for radio questions so the participant immediately sees where they made a mistake.
Even for an entertainment-focused quiz, however, it is worth deciding in advance how personal data will be handled. If the form collects email, name, or other information, you need clear consent wording, a minimal set of fields, and careful notification settings. The quiz add-on does not remove the normal requirements for forms and submission storage.
When the product may not be the right fit
Gravity Forms Quiz may be limiting if you need a complex learning path with lessons, attempts, timers, certificates, a question bank, student dashboards, and progress tracking by module. Those needs are usually handled by LMS plugins or specialized quiz builder tools. The add-on is also not the best choice if you need a public results directory, viral-style social sharing, or multi-step logic with hundreds of outcome screens without custom work.
What to Check Before Installation
Before installation, do not start with quiz design. First check the technical and editorial foundation: whether Gravity Forms is already installed, whether the add-on is available under your license type, whether the site environment meets Gravity Forms requirements, who will have access to entries, and what data will be collected. This reduces the risk of building the quiz only to find that it cannot be displayed or maintained properly.
Core dependencies
Gravity Forms Quiz works as an add-on for Gravity Forms, so the main Gravity Forms plugin must already be installed and active on the site. The official page states that the Quiz Add-On is available only with certain Gravity Forms licenses, so if the add-on does not appear under Forms - Add-Ons, first verify availability in your account and confirm the license tier. This guide does not need to cover purchasing or entering a key, but on live sites that is a common reason the add-on never appears in the installer.
The site environment should also be checked under Forms - System Status. For official support, Gravity Forms expects the current or previous version of WordPress and a supported PHP version. You do not need to include version numbers inside the quiz itself, but the administrator should understand that if the site has not been updated in a long time, the issue may not be the quiz field at all, but the environment, theme, or outdated core.
Editorial preparation of questions
Before configuring anything in the admin panel, prepare the questions in a table or document: the question, answer type, choices, correct answer, score, explanation, whether it is required, and the expected post-submission message. This is especially important for weighted scoring. If scores are invented directly inside the form editor, it is easy to end up with one question contributing far too much to the final percentage.
For each question, decide in advance which type fits best:
Radio Buttons- one answer out of several, the best choice for most training questions and forInstant Feedback.Drop Down- one answer when there are many choices and you need to save space, though this format is less clear for learning.Checkboxes- multiple correct answers, useful for "select all that apply" checks, but it requires careful score setup.
Data, privacy, and roles
A quiz form saves responses as Gravity Forms entries. That means before publishing, you need to decide who in the admin panel can access entries, whether email notifications are necessary, how long entries should be retained, and whether you are collecting unnecessary personal data. For a simple quiz, the result alone is often enough without a name. For employee training, you may need a participant identifier, but then access permissions and retention policy should be reviewed carefully.
A practical pre-launch check: create a test entry without real personal data, open the entry in the admin panel, and confirm that only the person responsible for handling it can see the result.
Installing the Add-On and Running the First Check
The official documentation describes several ways to install the add-on: through the add-ons browser in the admin panel, by uploading the ZIP under Plugins - Add New, or via FTP. For a typical site, the safest starting point is Forms - Add-Ons, because WordPress will install and activate the official package automatically if it is available.
- Open
Forms-Add-Onsin the WordPress admin panel. - Find
Quiz Add-Onand clickInstall. - After installation, click
Activate Plugin. - Open an existing form or create a new one under
Forms-New Form. - In the form editor, check the
Advanced Fieldssection for theQuizfield.
If the field appears, the add-on is installed. But the initial check should not stop there. Add one test question, save the form, and open Settings - Quiz. This section should appear after a quiz field has been added. If it does not, the most common causes are that the form still does not contain a Quiz field, the add-on is not active, or you are looking at the settings for a different form.
Mini quiz for installation testing
Create a temporary question with two answer choices and mark the correct one with the green checkmark. Save the form, place it on a private test page using the Gravity Forms block or shortcode, submit it as a regular visitor, and then review the entry. The entry should show which answer was selected and how it was graded.
For a temporary verification embed, you can use the standard Gravity Forms format:
[gravityform id="1" title="false" description="false" ajax="true"]
Replace id with the actual form ID. If the form does not display, first verify that a form with that ID exists and that it was not inserted into an area where shortcodes are not processed. If the form displays but no quiz result appears after submission, go back and review your grading and confirmation message settings.
Configuring Questions, Answers, and Explanations
Questions are the most important part of Gravity Forms Quiz. The plugin will correctly calculate whatever you configure, but it will not fix a poorly worded question, ambiguous answer choices, or an accidentally marked correct answer. That is why each quiz field should be configured in a clear sequence: question, selection format, answer choices, correct answers, scores, explanation, and a live check on the public page.
Quiz Question and description
The Quiz Question field contains the actual question. The description can be used for extra guidance, such as "Choose one answer," "You may select multiple answers," or "Answer after watching the video." If the question requires a long instructional context, it is usually better to place that context in a regular HTML block before the quiz field and keep the field itself short. That helps users immediately distinguish the instructions from the action they need to take.
Do not combine knowledge testing and data collection in the same question. For example, if you need to ask which department an employee belongs to and then test their understanding of an instruction, use a regular field for the department and a separate quiz field for the knowledge check. That makes results easier to filter and avoids mixing personal data with scoring logic.
Choosing the field type
Radio Buttons are the best fit for questions with one correct answer. They are the easiest to review, read well on the page, and work with Instant Feedback. Drop Down should be chosen more carefully: it saves space, but the user cannot see all options at once. In a training quiz, that can make the experience less clear.
Checkboxes are needed when there is more than one correct answer. The important detail here is that for the answer to be shown as correct, the participant must select all correct options. If weighted scoring is enabled, the percentage may be calculated more flexibly, but the correctness shown in the answer summary still depends on which correct choices were selected. For that reason, it is helpful to explicitly say in the field description that multiple answers may be selected.
Answer choices and stable values
Answer choices are added in the choices flyout. The correct answer is marked with a checkmark. If your labels use HTML, special characters, commas, vertical bars, parentheses, or similar elements, the official documentation recommends enabling choice values and assigning simple unique values. This reduces the risk of issues with conditional logic, calculations, dynamic population, and validation.
Do not change the order, labels, or composition of checkbox choices after the form has already collected entries. The documentation warns that changing checkbox choices can alter input IDs and break the mapping between saved entry data and the original options. If the quiz is already live and has accumulated data, the safer approach is to create a new version of the form or export the old results first.
Answer Explanation and instant feedback
Enable Answer Explanation adds an explanation for the answer. It is shown after the question when Instant Feedback is enabled at the form level. The explanation can also be inserted into confirmations or notifications through quiz merge tags. This works well for training quizzes because the user sees not only "correct" or "incorrect," but also why.
If the quiz is used for assessment rather than instruction, it is usually better to show explanations only after form submission or not show them at all. Instant feedback locks the selected answer until the form is reloaded and is intended for radio questions. It works well for self-study, but it should not be treated as anti-cheating protection or a strict exam mode.
What to check after configuring a question
- Each quiz field has at least one correct answer.
- The question type matches the real logic: one answer or multiple answers.
- The answer choices are not duplicated and do not look identical on a mobile screen.
- The explanation does not reveal the answer too early if the quiz is meant for assessment.
- After saving the form, the question displays correctly on the test page.
Grading: Standard Scores, Weighted Scoring, and the Final Grade
Grading in Gravity Forms Quiz has two parts. At the question level, you define which answers are correct and how many points each answer choice is worth. At the form level, you decide whether the result should become a final grade: no grade at all, Pass/Fail, or Letter grade. Most errors happen not because of the add-on itself, but because this relationship is misunderstood.
Standard scoring logic
With standard scoring, a correct answer gives 1 point and an incorrect answer gives 0. The percentage equals the share of correct answers. For straightforward knowledge checks, this is the clearest option: 8 correct answers out of 10 produces an intuitive result, and the administrator can easily explain what happened to the participant.
Standard scoring works well for short quizzes after instructions where all questions are roughly equal in importance. If one question is critical and another is secondary, weighted scoring is worth considering so they do not influence the final result equally.
Weighted scoring without surprises
When Weighted Score is enabled, a score field appears next to each choice. In a single-choice question, the overall maximum is based on the highest score. In a multi-choice question, the maximum is calculated as the sum of positive scores. This gives you flexibility, but it requires discipline. The answer you marked as correct affects the correct/incorrect summary display, while the scores themselves affect the percentage.
The documentation highlights an important nuance: in checkbox questions, a participant may receive a high percentage even if the answer is not considered fully correct in the summary. For example, if there are several correct options but the user selects only some of them, weighted scoring may still award partial credit. That is useful in training quizzes, but debatable in formal assessment.
The best rule for weighted scoring is to describe the scoring method in a table first, then transfer the scores into the form. If you want to penalize an extra selected option in a checkbox question, negative scores can help, but the final percentage will not drop below 0. Keep that in mind so you do not build a grading method around negative final results.
Pass/Fail and Letter grading
Under Settings - Quiz, you can leave Grading set to None, choose Pass/Fail, or select Letter. Pass/Fail works well for eligibility checks: for example, when a participant must reach at least a certain percentage to be considered passed. In the settings, you define the Pass Percentage and, if needed, different confirmation messages for passed and failed results.
Letter is useful when you need a level-based scale such as A, B, C, or your own letter labels. Each grade is assigned a minimum percentage. This works well for training and self-assessment, but it should be explained in the confirmation message so the participant does not just see a letter with no context.
Quiz merge tags in confirmations and notifications
Quiz Add-On adds merge tags that can be used in confirmation messages, notification messages, and quiz confirmation messages. The most useful ones are:
{quiz_score}
{quiz_percent}
{quiz_grade}
{quiz_passfail}
{all_quiz_results}
{quiz:id=3}
{quiz_score} outputs the total score, {quiz_percent} outputs the percentage, {quiz_grade} outputs the letter grade, {quiz_passfail} outputs Passed or Failed, and {all_quiz_results} displays the results of all quiz fields in the form. If you need a breakdown for a specific question, use {quiz:id=x}, where x is the quiz field ID.
Do not overload the message with every merge tag at once. For users, the percentage, status, and a short next step are usually enough. A detailed breakdown can be sent to the administrator or left in the entry. That keeps the confirmation easy to understand while preserving the details in the admin-side record.
Practical Example: A Quiz After a Training Page
Let us walk through a scenario that clearly shows how Gravity Forms Quiz works: the site publishes instructions for new employees or partners and places a short quiz underneath to check understanding of key rules. The goal is to show a clear result on the page, save the answers as entries, and give the administrator statistics on the questions users struggle with most.
Goal
After reading the instructions, the user answers 6 to 8 questions. If the result reaches the threshold, the user sees a passing message. If not, they are advised to review a specific section and try again later. The administrator checks Quiz Results to see which questions cause the most mistakes.
Preparation
Create a document with the questions. For each question, specify the correct answer and a short explanation. If the quiz is intended for assessment, do not enable Instant Feedback. If it is a practice quiz, do the opposite: add explanations and enable feedback for radio questions.
On the WordPress side, prepare a private page for testing. Do not publish the quiz directly into the main site navigation. It is better to place it first on a draft or on a page accessible only to administrators.
Setup steps
- Create a new form, for example
Training Quiz. - Add a regular name or email field only if it is genuinely needed to process the result.
- Add the first
Quizfield fromAdvanced Fields. - Enter the question in
Quiz Questionand chooseRadio Buttons. - Open the choices flyout, add the answer options, and mark the correct one with a checkmark.
- Add an
Answer Explanationif the quiz is for practice. - Repeat the process for the remaining questions.
- Open
Settings-Quiz, choosePass/Fail, and set the passing threshold. - Enable
Display Quiz Confirmationand write separate messages for passed and failed results. - Save the form and embed it on the test page using the Gravity Forms block or shortcode.
Verification
Submit the form twice: once with correct answers and once with mistakes. In the first case, the confirmation should show the success path; in the second, the failed message. Then open the form entries and Quiz Results. Confirm that the test submissions include a score, percentage, pass/fail status, and answers for each question.
Do not test the quiz with only one perfect attempt. Errors often appear on a failed submission: the wrong message, an empty merge tag, an unexpected percentage caused by weighted scoring, or a hidden question that is still counted as incorrect.
A nuance for conditional logic
If you hide quiz questions with conditional logic, keep the official scoring rule in mind: questions hidden by conditional logic at the time of submission are still counted as incorrect. This can reduce the percentage unexpectedly. For branching quizzes, it is usually better to use separate forms or avoid a shared overall percentage if participants see different sets of questions.
Practical Use Ideas for Different Sites
Gravity Forms Quiz is flexible enough to be used for more than a classroom-style quiz. Below are ideas based on confirmed add-on capabilities: quiz fields, automatic scoring, weighted scoring, grading, confirmations, entries, and the results dashboard. They do not require any fictional features, but they do require proper editorial preparation.
Introductory quiz for employees or partners
The site publishes instructions, policies, or a knowledge base and places a quiz at the bottom. It uses standard radio questions, Pass/Fail grading, and a confirmation message with the next step. The result is reviewed through entries and the Quiz Results screen. This setup is useful when it matters not just to show information, but to confirm that the person has actually read it.
Preparation level self-assessment
For an educational site, you can create a short "where should I start?" quiz. Letter grading or weighted scoring is usually a better fit here. In the confirmation message, the user does not get a grade for its own sake, but a recommendation: beginner material, an advanced section, or a consultation. Result validation is simple: run the form with several answer combinations and make sure the grade thresholds produce the recommendations you expect.
Qualifying a request before a consultation
The form can ask questions about the client's situation and assign points to the answers. For example, one option may indicate low readiness while another suggests high readiness. In the entry, the manager sees the percentage and the answers, while the user gets a soft message with the next step. This is exactly the kind of use case where you should not promise an automatic solution or replace expert judgment with a mechanical score.
Mini quiz inside a content article
For a blog or media site, you can add a short quiz after an article. In that case, answer explanations are appropriate and, if the format is educational, so is Instant Feedback. But if the page is heavily cached, make sure to test form submission and the confirmation display after clearing the cache. Quiz is still a form, and forms are more often broken by scripts, cache, or nonstandard embedding containers than by the questions themselves.
Displaying the Quiz on the Page and Checking the Result
Once the questions and grading are configured, the quiz needs to be displayed on a page. Gravity Forms supports several methods: a block in the WordPress editor, the embed interface, a shortcode, and insertion into a template via function. For most users, the block or shortcode is enough. The key is to test not just the visual layout after embedding, but the full submission flow.
How to embed the form
If you are using the block editor, add the Gravity Forms block and select the required form. If you are working in the Classic Editor, a page builder, or any area where a shortcode is more convenient, insert [gravityform] with the form ID. For AJAX submission, you can use the ajax="true" parameter, but after that you should always test the confirmation and page scrolling because the behavior may depend on the theme and container.
For a test page, it is usually enough to hide the title and description if the heading is already part of the page content:
[gravityform id="12" title="false" description="false" ajax="true"]
If the form does not appear, do not start by reviewing the quiz settings. First verify the form ID, confirm that Gravity Forms is active, check whether the shortcode is processed in the selected block, and look for JavaScript errors in the browser console.
What the user should see after submission
The user should not have to guess whether the form was submitted. The confirmation message should clearly state the result: percentage, status, grade, or next step. For a Pass/Fail scenario, it is convenient to split the message into two branches: passed and failed. For Letter grading, it is better to explain what the letter means and what the user should do next.
Example of simple confirmation logic without unnecessary detail:
Your result: {quiz_percent}
Status: {quiz_passfail}
Recommended next step: review the section on safety rules and retake the quiz.
If the form collects email, you can set up a notification for the administrator or the participant. But do not send the user an overly long breakdown if they already see it on the page. Duplication often creates confusion: the person reads one message in the browser and a different one in the email.
How an administrator should review statistics
After several test submissions, open Quiz Results. You should see total entries, average score, average percentage, score frequencies, grade frequency for Letter grading, and a question-by-question breakdown. If the average percentage looks strange, check the weighted scores, any questions hidden by conditional logic, and whether the choices were changed after submissions started coming in.
Minimum pre-publication check: submit once with correct answers, submit once with incorrect answers, review the entry, review
Quiz Results, test the form after clearing the cache, and check it on a mobile screen.
Limitations and Settings You Should Not Enable Automatically
Gravity Forms Quiz includes options that look useful but are not right for every quiz. They should not be turned on "just in case." The configuration should match the real purpose: training, engagement, qualification, or assessment.
Instant Feedback
Instant Feedback shows a correct/incorrect indicator and explanation immediately after the answer is selected. The documentation notes that once an answer is chosen, it cannot be changed without reloading the form, and the feature applies to radio button quiz fields and should not be considered secure enough for critical assessments. So it makes sense for practice quizzes, mini quizzes, and educational hints, but not for high-stakes qualification checks.
Shuffle quiz fields and Randomize Quiz Answers
Shuffle quiz fields changes the order of questions in the form, while Randomize Quiz Answers shuffles the choices for an individual question on the front end. This can help reduce simple answer copying in basic quizzes. But if the questions depend on earlier context, shuffling can break the logic. For example, a question like "What did you choose above?" stops making sense if a different block now appears above it.
Before enabling shuffling, go through the quiz as a user and make sure every question stands on its own. If a question refers to text, an image, or a previous answer, it is better to keep a fixed order.
Editing an old quiz with accumulated entries
The riskiest change is editing answer choices after users have already taken the quiz. For radio questions, the consequences are usually easier to track. For checkboxes, however, the official documentation explicitly warns that the connection between saved data and original choices may be broken. For published quizzes, the safest rule is versioning: significant changes should go into a new form or a duplicate of the existing form, not a silent edit of old answer options.
Hidden questions and conditional logic
The official scoring documentation states that questions hidden by conditional logic at the moment of submission are still counted as incorrect. This is critical for branching questionnaires. If the user sees only part of the questions but the final percentage is calculated from all of them, the result will be unfair. In cases like that, it is better not to use a single overall percentage or to split the branches into separate forms.
Common Issues and Troubleshooting
Most problems with Gravity Forms Quiz show up as "I cannot see the result," "the percentage is wrong," "the Quiz field never appeared," or "the confirmation behaves strangely." The easiest way to troubleshoot is not by intuition, but by following the chain: add-on installation, presence of the quiz field, form settings, page output, entry, and results dashboard.
The Quiz field is not visible in the form editor
Symptom: there is no Quiz field under Advanced Fields, even though Gravity Forms is installed.
A likely cause is that the add-on is not installed, not activated, or not available for the current site. Check Forms - Add-Ons, the list of active plugins, and the availability of Quiz Add-On in your Gravity Forms account. If the add-on was installed manually, verify that you uploaded the actual add-on ZIP file, not an extracted folder with the wrong directory level.
Fix: activate the add-on, refresh the form editor page, and create the test form again. If the field still does not appear, review the Gravity Forms system status and any PHP errors in the hosting log. Any rollback of recent theme updates or conflicting admin plugins should be done only after testing on a staging site.
The Quiz Settings section does not appear
Symptom: the add-on is active, the Quiz field exists, but the form's Settings menu has no Quiz section.
A common reason is that the form still does not contain a saved quiz field, or you opened the settings for a different form. Add at least one Quiz field, fill in the question, save the form, and open Settings again. The documentation states that quiz-specific settings appear only after a Quiz Field has been added.
If the section still does not appear after saving, temporarily disable plugins that modify the Gravity Forms editor and check the browser console. A JavaScript error in the admin panel may be interfering with the interface even though the add-on itself is active.
The percentage or score does not match expectations
Symptom: the participant gets "almost everything right," but the percentage looks unexpectedly low or high.
Check three things: whether weighted scoring is enabled, whether there are checkbox questions with multiple correct answers, and whether any questions hidden by conditional logic are being used. In weighted scoring, the single-choice maximum is based on the highest score, while the multi-choice maximum is based on the sum of positive scores. Hidden conditional logic questions are counted as incorrect, which can lower the final result.
Fix: make a copy of the form, recalculate the scoring method using test data, temporarily disable conditional logic for verification, and submit several control entries. Do not change scoring in a published form with accumulated results without leaving a note for the team, because results are recalculated dynamically when viewed.
The confirmation message does not show quiz data
Symptom: the form submits, but instead of a percentage or grade, you see an empty result or a standard message without the quiz block.
First check where the merge tag is being used. Quiz merge tags are available in confirmations, notifications, and quiz confirmation messages. Then confirm that a grading type is selected if you are using {quiz_grade} or {quiz_passfail}. For {quiz:id=x}, verify the ID of the specific quiz field.
If AJAX is enabled, test the form without ajax="true". If the confirmation works without AJAX, the issue may be related to the theme, cache, script optimization, or a nonstandard page builder container.
Instant Feedback behaves differently than expected
Symptom: feedback does not appear, the answer cannot be changed, the explanation does not display, or the feature does not work for the intended question.
Check the quiz field type. The official documentation limits Instant Feedback to radio button quiz fields. Also confirm that Enable Answer Explanation is enabled for the question if you expect explanatory text. The inability to change the answer after selection is not a bug, but documented behavior.
Fix: for a practice quiz, keep Instant Feedback enabled and use radio questions. For an assessment quiz, disable the feature, show the result after submission, and rely on the confirmation message instead.
The form does not submit or breaks on the page
Symptom: the submit button does not work, the confirmation does not appear, the page scrolls strangely, or the quiz behaves differently inside a page builder.
Test the form on a simple page with a standard theme or a minimal plugin set. Clear the cache, disable script combining and deferred loading for the form page, and check the browser console. In Gravity Forms support discussions, there are cases where cache or a third-party plugin affected the confirmation flow.
If the issue disappears on a simple page, do not change the quiz settings. Look for the conflict in the theme, cache plugin, popup container, or page builder. Roll back the last change made before submissions stopped working, not the entire form.
Questions and Answers About Gravity Forms Quiz
Can you use Gravity Forms Quiz without the main Gravity Forms plugin?
No. It is an add-on, not a standalone quiz plugin. Gravity Forms must be installed and active on the site, and the Quiz Add-On itself must also be available and activated.
Where is the Quiz field after installation?
In the form editor, the Quiz field is located in the Advanced Fields section. If it is missing, check that the add-on is activated and refresh the editor page. After adding a quiz field, the form also gets a Settings - Quiz section.
Can the correct answer be shown immediately after selection?
Yes. That is what Instant Feedback at the form level and Enable Answer Explanation at the question level are for. But the feature is intended for radio button quiz fields and practice scenarios. It should not be treated as a secure mode for high-stakes assessments.
Why was a checkbox question scored differently than expected?
Checkbox questions have several nuances. For the answer to be shown as correct, the user must select all correct options. With weighted scoring, percentages may be awarded partially, and the maximum is calculated from the sum of positive scores. If the user selects an extra option, the summary may still treat the answer as incorrect even if the percentage is high.
Can answers be changed after users have already taken the quiz?
Technically yes, but it is risky. This is especially true for checkbox choices: changing the order, labels, or composition of options can break the connection to saved entry data. For serious quizzes, it is safer to create a new version of the form or export the old results first.
Which merge tags should be used in the post-quiz message?
In most cases, {quiz_percent}, {quiz_passfail}, or {quiz_grade} are enough. For a full breakdown, you can use {all_quiz_results}, and for a specific question, {quiz:id=x}. Do not add every tag at once if the user only needs the next step.
Is this add-on suitable for a serious exam?
For a basic knowledge check, yes, if a form, automatic result, and saved entries are enough. For a strict exam with anti-cheating measures, attempts, a timer, a question bank, proctoring, or certificates, it is better to look at a specialized LMS or a dedicated quiz builder.
Does a quiz form affect site performance?
Quiz is still a Gravity Forms form, so performance is influenced more by the overall weight of the page, the theme, the page builder, cache, and script optimization. Test the form page after publishing, do not disable Gravity Forms scripts through optimization tools, and always test submissions after clearing the cache.
When Gravity Forms Quiz Is the Right Choice
Gravity Forms Quiz is a strong option when you need a quiz inside a familiar WordPress form: questions, automated grading, a confirmation message, saved answers, and statistics in the admin panel. It is especially well suited to sites where Gravity Forms is already the main tool for inquiries, registrations, surveys, and internal workflows.
Before publishing, verify not just the visual side of the form, but also the scoring method, passing conditions, test entries, Quiz Results, mobile display, cache behavior, and the accuracy of your merge tags. If everything checks out, you can move on to the install file and start testing on your own site: download the ZIP archive.
If your needs have grown into a full course, complex category-based scoring, or a protected exam, do not try to force the add-on to do everything at once. In that case, Gravity Forms Quiz can still be useful for short checks and lead forms, while the main learning logic is better handled by a specialized tool.


