QSM Advanced Assessment - WordPress Plugin
QSM Advanced Assessment is a plugin crafted to elevate the capabilities of a WordPress site by incorporating comprehensive evaluation tools. This addition allows users to develop intricate quizzes and surveys, simplifying the evaluation process for both educators and businesses.

Plugin Features
By integrating this supportive tool into a website, the creation of personalized quizzes and surveys becomes effortless. Its user-friendly interface ensures that even those with limited technical know-how can craft assessments tailored to specific requirements. The extensions flexibility allows users to customize assessments with diverse question formats and utilize conditional logic that adjusts based on participants responses. Such adaptability ensures these evaluations remain engaging and relevant, serving a multitude of scenarios from educational settings to customer feedback systems.
QSM Advanced Assessment extensive suite of features includes time restrictions and scoring mechanisms to challenge and incentivize respondents. Equally, it offers robust analytics and reporting functions, enabling administrators to extract valuable insights from gathered data. Such in-depth analysis proves vital for educators monitoring academic progress or businesses eager to gauge customer preferences and satisfaction.
A standout quality of this solution is its easy compatibility with various third-party applications. By integrating with platforms like Google Sheets, it automates data collection and refines workflow processes. Additionally, it supports sending notifications via email or other messaging services, maintaining stakeholder engagement without manual effort. This level of automation not only reduces administrative tasks but also enhances the flexibility and effectiveness of the assessment system.
To further optimize user experience, customizable style settings are included. Users can modify the visual aspects of quizzes and surveys to align with brand aesthetics, maintaining coherence across the digital interface. This attention to design detail supports an immersive and cohesive user experience, engaging participants while subtly promoting brand identity.
Ultimately, QSM Advanced Assessment is an essential tool for educators and enterprises eager to improve their evaluation methodologies. Its complete feature set, user-centric interface, and seamless integration into existing digital frameworks make it an invaluable asset for gathering insights and fostering meaningful engagement with target audiences.
How to Configure QSM Advanced Assessment for Personalized Results in WordPress
QSM Advanced Assessment is not meant for a standard quiz with a single final score. It is designed for cases where a respondent's answers need to be turned into a profile, type, recommendation, or detailed interpretation. In this guide, we'll walk through a practical setup process: how to prepare the foundation in Quiz and Survey Master, enable the add-on for a specific form, choose the right scoring model, connect answers to outcomes, verify the frontend output, and stay in control of the conditions.
This article is for site owners, editors, instructional designers, marketers, and developers who already know why they need a survey or quiz, but want the form to stay useful after submission. Instead of a short summary of the product page, you'll get a working framework: where the key QSM Advanced Assessment settings live, how "options," "labels," and "category" differ, how to design scoring scales, why a result may not match expectations, and how to troubleshoot the issue safely.
The examples below use a career profiler workflow: a visitor answers questions, their choices add points across several dimensions, and the results page shows a dominant profile, a distribution table, and recommended next steps. The same approach can be used for a personality quiz, consultation survey, learning module, product recommendation, internal HR questionnaire, or audience research project.
What the Add-On Actually Adds to Standard QSM
Base Quiz and Survey Master already lets you build quizzes and surveys, add questions, show different results pages, send emails, and embed forms through a block, widget, or shortcode. QSM Advanced Assessment extends that foundation in the places where a standard total score is not enough. It lets you evaluate not just the overall quiz score, but also which answer positions, labels, or categories scored highest, lowest, or landed within a defined range.
The real value of the add-on is that it lets you turn a set of answers into a diagnosable result model. The participant selects options, and the administrator decides in advance what those options mean: the first option across all questions may map to one type, a specific label may represent a tendency or competency, and a question category may reflect performance in a separate knowledge area. After submission, QSM compares the accumulated values against your conditions and displays the matching results page or email.
The official documentation highlights several working approaches. In the answer-position model, the outcome depends on which answer positions the participant selected most often, such as the first, second, or third option. In the label-based model, each answer is assigned labels, and the result is based on the counts or points for those labels. In the category-based model, groups of questions are evaluated: a category can be checked by total points or correct percentage, and the condition can look for the maximum, minimum, or an exact value. The add-on also includes variables and shortcodes for displaying label data distribution in results and emails.
This matters before installation because the add-on does not invent a methodology for you. It provides the mechanism, but the quality of the final profile depends on how the questions are structured. If "strategist," "operator," and "communicator" appear in one order in one question and then get rearranged in the next, an option-based setup will stop measuring types and start measuring chaos. If you use a label-based setup without a deliberate scale, the winning profile may simply be the label that had the most chances to collect points, not the most accurate match.
That is why QSM Advanced Assessment is best understood as an evaluation layer on top of QSM, not as a standalone psychological instrument. For entertainment quizzes, that is often enough: the participant gets a type, a suggestion, or a recommendation. For education, hiring, healthcare, financial decision-making, or any sensitive diagnostic use case, you need a separate methodology, reviewed wording, appropriate legal language, and a careful explanation of limitations. In this article, we are focusing on technical setup and editorial structure, not on the guaranteed validity of psychological testing.
The Product Mechanics That Matter Most
The add-on has several signature mechanics worth keeping in mind throughout implementation.
-
Assessment is enabled at the individual form level. In the QSM settings for the selected quiz or survey, open the Advanced Assessment add-on and enable
Assess this form. If that checkbox is not enabled, the assessment rules will not be applied to that form. - Answer labels act as a hidden semantic layer. Labels are assigned to answers and are usually invisible to the participant while taking the quiz, but they are what make a personalized profile possible.
-
Separate points for labels. When
Label Pointsis enabled, a single answer can assign different values to different labels. This is useful for hybrid answers that partially belong to more than one type. - Result conditions based on options, labels, and categories. In Result Pages, you can evaluate count, total points, correct percentage, and dynamic variables when you need to compare one value against another.
-
Variables and label shortcodes in results. The add-on provides variables such as
%MOST_SELECTED_LABEL%,%HIGHEST_SCORING_LABEL%, and a label details table so the outcome is more than just "your type is A" and can show a full distribution. - Variables have scope limitations. The documentation specifically notes that Advanced Assessment variables apply to label-based conditions, not option-only logic. That has a direct impact on how you design your result architecture.
When This Product Fits and When Another Approach Makes More Sense
QSM Advanced Assessment is especially well suited to sites where the result needs to explain more than just "right or wrong" and instead answer "which direction this person leans toward." That includes career quizzes, learning style surveys, internal skills assessments, product matching, audience segmentation, lightweight psychometric questionnaires for content projects, coaching assessments, and educational diagnostics. In these use cases, the person wants a personalized interpretation, while the site owner wants to keep form and data control inside WordPress.
The add-on is particularly convenient if you already use QSM or plan to build the form on QSM from the start. Base QSM handles questions, pages, contact fields, block or shortcode output, results, and emails. Advanced Assessment adds the layer that connects answers to deeper profiles. That saves time: you do not need to build a separate plugin, store answers in an external service, or manually calculate labels in a spreadsheet.
That said, there are use cases where the product may be unnecessary or not enough. If you only need a simple knowledge quiz with one passing score, standard QSM may already cover it. If you need a complex branching funnel with aggressive lead generation, social badges, A/B testing, and a dedicated visual builder for results pages, it is worth comparing QSM with Thrive Quiz Builder or the WPForms Quiz Addon. If you need strict LMS-style assessment with grade tracking, student roles, and lessons, QSM alone may not be enough without an additional learning system.
You should also be careful with sensitive assessments. The product page and documentation mention personality quizzes, psychometric tests, career aptitude, wellness, and market research, but that does not mean every custom survey automatically becomes a validated methodology. For serious HR, medical, psychological, or financial conclusions, it is better to use QSM Advanced Assessment as the technical shell and have the actual content reviewed by a qualified specialist. On the results page itself, it is wise to say that the outcome is directional, not a diagnosis or a final decision.
Comparing Common Use Cases
| Use Case | How the Add-On Helps | What to Check in Advance |
|---|---|---|
| Personality or behavior-style quiz | Labels and label points build a profile across multiple types, and the result shows the dominant label plus the distribution. | Balanced questions, no overly obvious answers, and clear boundaries between types. |
| Career or product recommendation | Each answer adds points to one or more directions, and the result leads to the most appropriate recommendation. | Whether recommendations conflict with one another and whether there is a fallback for close results. |
| Learning module | Categories let you assess knowledge sections separately, and conditions can show strengths and weak spots. | Whether categories are assigned correctly, the quiz is published, and Result Pages are configured. |
| Audience research | Label counts and tables help show respondents which preferences appeared most often, while giving the site owner a structured analysis model. | What data is being collected, whether a contact form is present, and whether reporting or export integrations are needed. |
What to Check Before Installation and Before Enabling Assessment
Before installing QSM Advanced Assessment, do not start with the ZIP file. First make sure the site is ready for the very idea of a personalized outcome. In QSM Core, the form should already exist or at least be designed: the form type, question list, answer choices, categories, result text, email logic, and publication location. Without that, the add-on may be enabled, but the administrator still will not know which labels and conditions to create.
The first technical check is the version and status of the main QSM plugin. The Advanced Assessment documentation lists QSM Core 9.0 or higher as a requirement. In practice, it is better to keep both QSM Core and the add-on updated, because the changelogs for both QSM Core and Advanced Assessment show regular fixes for security, validation, SQL queries, REST checks, chart upload validation, and result condition behavior. You do not need to mention specific versions in the article interface or images, but inside the site admin, it is worth opening Plugins before implementation to confirm that QSM Core is active and the site is not running an outdated branch.
The second check is the add-on installation method. QSM offers a newer QSM Addon Installer, where add-ons and licenses are managed under QSM > Extensions > Addon Installer, as well as the older manual route through Plugins > Add New > Upload Plugin. If you use a bundle license, the documentation describes License Manager. If you use an individual add-on key, the documentation outlines the manual activation route. We are not covering purchase or license retrieval in this guide, but for the add-on to work, it must be installed correctly in the admin and be active.
The third check is the scoring methodology. For an option-based setup, the order of answer choices must remain consistent. For a label-based setup, you need a predefined list of labels and a clear decision about how many points each answer should assign. For a category-based setup, questions need to be assigned to categories correctly. This may sound like a minor editorial detail, but most strange outcomes begin here: the author reorders answer choices for style, adds a question without a label, forgets a category, or creates only winner-based results without leaving a default result in place.
The fourth check is the publication method. QSM supports output through Embed Shortcode, Link Shortcode, widget, and Gutenberg block. The documentation warns that the same Quiz/Survey Shortcode should not be placed twice on the same page, because QSM does not support rendering the same quiz ID twice on one URL. If you are testing results, create a separate draft page or use a single embed instance. Duplicate forms on the page make troubleshooting harder: it may look like Advanced Assessment is calculating incorrectly when the real issue is the form being rendered twice.
The fifth check is theme, cache, and CSS conflicts. QSM includes its own themes and Style tab, along with Custom Style CSS support. The CSS documentation warns that Custom mode can replace styles for a specific quiz or survey, so it should not be enabled without understanding the effect. If the result display breaks, start by checking the default style, disabling aggressive minification for the quiz page, and confirming that the page does not contain two identical shortcodes. Only after that should you edit CSS.
Safe preparation: before implementation, create a copy of the form or a separate test quiz, complete it as a regular visitor, save your expected answer patterns, and only then move the label, point, and result-condition setup into the live version.
Installing the Add-On, Enabling It, and Running the First Check
Installation has two layers. First, WordPress needs to show an active QSM Core plugin and an active Advanced Assessment add-on. Then the specific quiz or survey needs assessment enabled in its own settings. Those are different things: seeing an active plugin in the Plugins list does not mean the selected form will be evaluated by Advanced Assessment.
If you are using the QSM Addon Installer, open QSM > Extensions, confirm that Advanced Assessment appears in the list of add-ons, and activate it using the built-in toggle. If the add-on is installed manually, upload the ZIP through Plugins > Add New > Upload Plugin, install it, activate it, and then verify it in QSM's installed extensions list. In either case, do not try to bypass activation or move files from questionable mirrors: for updates and security fixes to work properly, the installed add-on needs to match the developer's official source.
After installation, open the quiz or survey you want to use. In the QSM editor, go to the add-ons tab and choose Advanced Assessment from the dropdown. The documentation describes the critical step: enable the Assess this form checkbox. Without it, the form remains a normal QSM form even if the add-on itself is active. If you plan to use separate points by label, this is also where you enable Label Points, after which the question editor lets you assign individual values next to the selected labels.
Minimal Initial Verification
Do not jump straight to dozens of questions. Create a short test form with three questions and three answer choices each. Assign labels, or make sure the option positions are consistent. Create three results pages and set simple conditions: one result for the highest first label, one for the highest second label, and one for the highest third label. Complete the form three times, each time choosing answers from only one profile. If the result matches your expectation, the mechanism is enabled correctly.
This short test is not necessary because QSM Advanced Assessment is technically difficult. It matters because it helps separate three different error zones: add-on installation, label or point assignment, and Result Pages conditions. If the mini test works but the full quiz does not, the problem is almost certainly in the question structure or conditions, not in the installation. That can cut troubleshooting time from hours down to minutes.
What Not to Do at the Beginning
Do not enable every possible mode at once. If your first workflow is label-based, do not try to calculate option positions and category correct percentage in the same results pages before the basic setup is verified. Do not style the form with custom CSS before confirming the result logic. Do not reorder answers after assigning option-based conditions. Do not create overly narrow conditions like "exactly 20 points" when a participant may land just above or below that and see the default result instead. Ranges and fallback rules are usually more reliable.
How to Choose Between Option-Based, Label-Based, and Category-Based Assessment
Choosing the scoring mode is the main architectural decision in QSM Advanced Assessment. A mistake here does not lead to a cosmetic fix. It leads to rebuilding every question. That is why it helps to map out the outcome on paper first: which profiles are needed, which traits distinguish them, whether one answer can belong to multiple profiles, whether you need to show a distribution, and whether question categories should stay separate from personality types.
Option-Based Assessment: Fast but Fragile
The option-based approach scores answers by their position. For example, in every question the first answer corresponds to an extroverted type, the second to a mixed type, and the third to an introverted type. The result can be based on count or total points in the selected position. This is the fastest setup for a short, symmetrical quiz where the questions were written around the same answer matrix from the start.
Its weak point is order. The documentation explicitly emphasizes that the same order of options must be preserved across questions for accurate scoring. If an editor rearranges options in the middle of the form to make the wording sound more natural, the system still evaluates "Option 1," "Option 2," and "Option 3," not the meaning of the answers. That is why an option-based setup only makes sense when the order can remain stable without hurting the user experience.
For longer quizzes, personalized recommendations, and mixed profiles, it is usually better to replace an option-based setup with labels. It works well as a prototype or a simple personality quiz, but it does not hold up as well under a more sophisticated methodology.
Label-Based Assessment: The Main Mode for Personalized Profiles
The label-based model is built around hidden labels. Each answer has one or more labels, and the result conditions evaluate count or total points for the selected label. This is more robust: you can change the order of answer choices, and the meaning still stays attached to the label. If an answer partially belongs to two types, you can assign multiple labels. If Label Points is enabled, one answer can contribute different scores to different labels.
For QSM Advanced Assessment, this is the most flexible mode. It unlocks variables like %MOST_SELECTED_LABEL%, %LEAST_SELECTED_LABEL%, %HIGHEST_SCORING_LABEL%, %LOWEST_SCORING_LABEL%, pie chart variables, percentage variables, and the label details shortcode. This is where the result becomes truly useful: the user sees not only the winning type, but also the distribution across the other dimensions.
If your goal is a personalized interpretation, label-based assessment is usually the best choice. It requires more preparation, but it is easier to maintain. You can rename an answer choice, improve the wording of a question, or add clarification without breaking the calculation, as long as the label itself remains correct.
Category-Based Assessment: For Knowledge Areas and Competencies
The category-based model evaluates question categories. It is useful when you care less about personality type and more about areas such as "communication," "analytics," "time management," or "technical foundation." The documentation notes that category result conditions can evaluate total points or correct percentage within the selected category, as well as maximum, minimum, and other condition types.
This mode works well for educational and professional testing. For example, in a career profiler you might use labels for the final type and categories for topic-specific competency areas. But do not combine everything into a single result unless there is a clear reason. If the primary result needs to identify a type, use labels. If you want to show strong and weak knowledge areas, use categories. If you need both, explain the distinction to the user: type reflects a preference profile, while category reflects an area of competence.
Dynamic Condition Variables
A separate advanced layer involves conditions that use template variables. The Results Conditions for Advanced Assessment documentation describes the ability to compare values across labels, options, and categories, such as label points versus category points, or two category scores. This is useful for more nuanced rules: for example, showing a result if a leadership label is not only the highest, but also higher than a specific category, or when two directions are tied and a mixed profile is needed.
Use this layer only after the basic setup is validated. Dynamic comparisons are powerful, but they are also harder for editors to manage. In your methodology notes, it helps to write every condition in plain language, such as: "Show the mentor profile if Leadership points are higher than Communication category points and the Collaboration label is not below average." Otherwise, a month later nobody will understand why the result fires the way it does.
Designing Labels and Scales Before You Add Questions
The most common mistake in quizzes with personalized outcomes is writing the questions first and then trying to attach labels afterward. With QSM Advanced Assessment, it is better to work in reverse. Start by defining 3 to 6 final directions, then decide which traits support each one, and only after that write the questions. That way, labels are not random tags. They become the actual scoring framework.
For a career profiler, you might choose four labels: "Strategy," "Operations," "Communication," and "Creative." For each direction, define the behavior it represents: how the person makes decisions, plans, interacts with others, and what kind of task format they prefer. Then each question tests one aspect, and each answer adds points to one or more labels.
It is important not to overload answers with too many labels. If every option gets 3 or 4 labels, the result becomes too diluted. Separate points for labels should be used when an answer is genuinely mixed. For example, the answer "I like explaining complex ideas through diagrams" could assign 2 points to Communication and 1 point to Strategy. But if every answer contributes a little to every label, the final difference will depend more on random numbers than on actual meaning.
A Simple Scale Model
For your first implementation, use a clear scale:
- Main profile answer: 3 points to the primary label.
- Mixed answer: 2 points to the primary label and 1 point to a secondary label.
- Neutral answer: 1 point to one label, or 0 if your methodology allows no contribution.
- Do not use negative values unless the documentation for the specific field and use case explicitly confirms that they are supported correctly.
This kind of scale is easier to verify. You can calculate a control run in advance: if the participant chooses all strategy answers, Strategy should win. If they choose half Strategy and half Communication, either a mixed result or the default result with close-profile messaging may be appropriate. The key is to decide ahead of time how ties should be handled.
Label Names and Slugs
In QSM, labels can be created and managed under QSM > Answer Labels. The documentation describes fields for label name, slug, description, and assignment to a specific quiz or all quizzes. For editorial maintenance, it is better to give labels short, stable names in English or in a clear internal transliteration, and display user-facing names in the result text instead. You should avoid changing the slug after configuring result variables, because variables such as %ANSWER_LABEL_COUNTS_X% and %ANSWER_LABEL_POINTS_X% rely on the label slug.
A label description is useful not just for the original author. If multiple editors work on the team, the description helps clarify what the label means and which answers belong to it. For example, "Strategy - long-term planning, uncertainty analysis, direction-setting; do not confuse with Operations, where process and order matter more." This kind of internal discipline reduces the chance that a new question will be tagged with the wrong label.
How to Check Balance
Before publishing, build a matrix. Put questions on the rows and labels on the columns. In each cell, note how many points a label can receive from that question. If one label appears in 12 questions and another appears in only 6, the outcome will be skewed. If one type gets more mixed answers, it will show up as second place more often even when the user did not strongly select it. QSM Advanced Assessment will not warn you about methodological imbalance, so the author needs to verify scale balance before setup.
Configuring Questions: Answers, Labels, Points, and Categories
Once the methodology is ready, you can move into the QSM question editor. Start by adding or reviewing the questions themselves. The QSM Questions tab documentation shows that QSM supports various question types and answer types, but Advanced Assessment lists supported question types as multiple-choice, multiple-choice horizontal, multiple response, and multiple response horizontal. That means you should not rely on arbitrary open text fields for Advanced Assessment calculations unless the documentation explicitly confirms that they participate in label scoring.
For each question, write the prompt so the answer choices actually distinguish between profiles. A weak question would be: "What do you like most?" with choices like "working," "resting," and "socializing." It is too broad. A stronger version would be: "How do you usually begin a new complex task?" with choices like: "I gather the inputs and build a few hypotheses," "I break the task into short steps," "I clarify expectations with the people involved," and "I look for an unconventional picture of the final outcome." That kind of question is much easier to connect to labels.
After adding the answer choices, open the label dropdown next to answer points. The Advanced Assessment documentation describes the Select Labels field, where you can choose an existing label or create a new one. If Label Points is enabled, an input field appears next to the labels for separate point values. Assign labels immediately as you finish each question instead of postponing it until the end. That makes it easier to spot when a question does not fit the intended model.
Multiple Response and the Risk of Inflated Scores
Multiple response allows the participant to select several answers. That works well for preference surveys, but in an assessment it can inflate the weight of a single question. If a question allows three selections and each one contributes 3 points, that one question may carry the weight of three normal questions. This is not a QSM error. It is a methodology issue. The solution is to either limit the number of selections, if the QSM question settings allow it, reduce the points for those questions, or deliberately treat a multiple response question as more heavily weighted.
Before publishing, take the test once as a "maximalist" by selecting every allowed option, and once as a "minimalist" by choosing only one. Compare the outcome. If the multiple response format completely changes the profile, the question may need to be split into several single-choice questions.
Question Categories
If you are using category-based assessment, assign categories not as a cosmetic admin grouping but as a calculation layer. In QSM, a question category can participate in result conditions, so the category needs to be stable and meaningful. For example, "Soft Skills" is too broad for diagnostics, while "Communication," "Planning," and "Analysis" can actually be compared.
In an educational test, categories usually map best to sections of the curriculum. In a career profiler, categories may represent competencies while labels represent final types. In that case, a results page might say: "Your primary profile is Strategy, and your strongest competency area is Analysis." But if your audience is not ready for two separate systems, keep one. One clear result is better than a complex table nobody can interpret.
Checking Each Question
After configuring each block, do a short manual review:
- Open the question and read all answer choices without looking at the labels.
- Try to guess which label each answer should map to.
- Compare that with the actual labels in QSM.
- Check the points to make sure there is no accidental 30 instead of 3, or a blank value.
- Save the question and do not reorder the answers without reviewing it again.
This routine may feel slow, but it is cheaper than dealing with complaints like "I answered like a strategist and got communicator."
Results Pages: Conditions, Defaults, and Personalized Interpretation
Result Pages are where QSM Advanced Assessment becomes visible to the participant. In QSM, you can create one default page or multiple pages with conditions. With Advanced Assessment, you can add conditions based not only on the overall quiz score, but also on options, labels, or categories. The quality of your results pages determines whether the quiz feels like a useful assessment or a random toy.
Start with the default result. This is the fallback shown when no condition matches. The QSM Results Page documentation recommends marking a default template as a fallback. In an assessment, that is especially important because of ties, boundary values, and incomplete rule sets. The default result should not feel like an error. Give it neutral language such as: "Your answers were closely distributed across several directions. The strongest areas are shown below, and for a more precise recommendation it may help to take the quiz again without skipping questions."
Then create pages for the main profiles. In a label-based setup, for each label you can create a condition with mode Label, the label name, calculation type Count or Total Points, and a condition like is maximum or a range. In an option-based setup, choose mode Options, the answer position, and count or total points. In a category-based setup, choose mode Category, the category name, calculation type Total Points or Correct Percentage, and then the condition.
When to Use Maximum and When to Use Ranges
is maximum works well when you simply need a winner, meaning whichever label scored highest. But maximum can be unstable when scores are tied. The Advanced Assessment changelog mentions improvements to the logic for handling tie results, but from a methodology standpoint it is still better to decide in advance how close profiles should be handled. For a serious interpretation, ranges are often more useful: for example, Strategy points greater than or equal to 18 and Communication points less than 15. That way, the result triggers not because one label barely beats the next one, but because the profile is genuinely strong.
Ranges matter even more in small quizzes. With only a few questions, one answer can dramatically change the top score. A participant may choose 4 Strategy answers and 3 Communication answers, receive Strategy, but still see themselves as mixed. For that reason, in a short quiz it helps to mention close secondary directions through a label table or use the default result for tied values.
Personalized Result Copy
The results page should include three layers. First, the short profile name. Second, an explanation of why this profile may have appeared. Third, practical next steps. For example: "Your leading profile is Strategy. This usually happens when your answers point more often toward analysis, direction-setting, and working with uncertainty. Check the table below: if Communication is close to Strategy, you may do best in roles where you not only plan, but also explain decisions to a team."
Do not promise more than the quiz actually measures. If it is a marketing-oriented product recommendation quiz, it is fine to recommend a product category or service. If it is a psychometric questionnaire, it is better to say "your response profile is similar to..." and "use this as a directional guide." The more serious the topic, the more careful the result wording needs to be.
HTML Inside the Result Page
The Advanced Assessment documentation shows an example where the results page uses simple HTML to create a dashboard-like feel. That is acceptable if you understand where the code is being inserted and how it affects the theme. It is best to start with a simple block: a heading, a paragraph, a list of recommendations, and a label details table. Add complex grids and CSS only after the logic is validated, otherwise a layout error may hide a condition error.
Variables, the Label Details Table, and Post-Submission Email
One of the strongest parts of QSM Advanced Assessment is the ability to show the participant not just a final profile, but a distribution of data. The documentation lists variables for counts, points, percentages, pie charts, most selected, least selected, highest scoring, and lowest scoring labels. It also includes a Label Shortcode option where you can configure a table with sort order, sort field, columns, column headings, and limit.
For the user, this turns the outcome from a black box into something explainable. They can see that Strategy received the most points, Communication came close, Operations was lower, and Creative barely appeared. Even if they do not fully agree with the leading profile, the table helps them understand which answers influenced the result. For the site owner, that reduces questions and builds trust.
Which Variables to Use Carefully
The documentation includes an important note: variables are only applicable for label-based conditions and not for options. So if you are building an option-only quiz, you should not expect label variables to produce useful statistics. For richer interpretation, it is often better to use labels even when option positions seem simpler.
A practical result set looks like this:
-
%MOST_SELECTED_LABEL%or%HIGHEST_SCORING_LABEL%for a short summary of the leading direction. -
%ANSWER_LABEL_POINTS%or a configured label details table to show point distribution. -
%ANSWER_LABEL_PERCENTAGE%or a percentage column in the table for side-by-side comparison. - A pie chart variable if the result genuinely benefits from a chart instead of overloading the page.
Do not insert every variable at once. The user came for an answer, not for internal accounting. In most cases, one primary result, 3 to 4 paragraphs of interpretation, a label table, and a practical list of next steps are enough.
Configuring Email
The QSM Emails tab lets you send messages to the participant and the administrator after submission. The email documentation covers send conditions, templates, template variables, and ways to disable email delivery by removing addresses or changing submit actions. For Advanced Assessment, email is useful when the result is long, includes resources, or should remain available after the participant closes the page.
Do not duplicate the entire results page in the email. It is better to send a short profile summary, a link to the saved result, 2 to 3 recommendations, and a note about what to do next. If you collect email through a contact form, make sure the user understands why they are providing it. On public sites, it is also wise to include consent language and avoid sending sensitive interpretations unless there is a clear reason.
How Not to Break the Result with Excessive Design
If you insert the label details table into a results page, test it first using the default QSM style. Then, if needed, add light CSS adjustments. The QSM CSS documentation lists classes such as qsm-quiz-container, qsm-quiz-form, qsm-error-message, mlw_qmn_quiz, mlw_qmn_question, and others. But for an Advanced Assessment result, you should avoid writing aggressive selectors that affect every QSM form on the site.
It is safer to use the page container or block ID around the specific quiz if the theme provides one. If no stable wrapper exists, keep the styles inside the QSM Style tab for that individual form and do not edit theme or plugin files.
Practical Example: A Career Profiler with Four Directions
Now let us build a concrete use case. The goal is to create a WordPress-based career profiler for visitors to an educational site. After completing it, the user should see their leading work style: Strategy, Operations, Communication, or Creative. They should also see a distribution table, a short interpretation, and a recommendation for what to read next.
Goal and Preparation
This is not an exam and it does not have right answers. That is why we are choosing label-based assessment. Base QSM Core is installed, Advanced Assessment is activated, the quiz is created, and the Assess this form checkbox is enabled. In QSM > Answer Labels, create four labels: strategy, operations, communication, and creative. In each label description, define what it means for the editorial team.
The question plan: 12 questions, each with 4 answer choices. Most answers assign 3 points to one label. Some mixed answers assign 2 points to a primary label and 1 point to an adjacent label if Label Points is enabled. That gives you enough data without exhausting the participant.
Configuration Steps
- Open the created quiz in QSM and add the first question: "How do you begin a new project when the initial information is limited?"
- Add four answers: "I build hypotheses and map the risks," "I make a list of actions and deadlines," "I clarify expectations with the people involved," and "I look for an unconventional picture of the final outcome."
- Assign labels: first answer -
strategy, second -operations, third -communication, fourth -creative. - If you are using separate label points, assign 3 points to each primary answer. For mixed answers in later questions, use 2 + 1.
- Repeat the process for the remaining questions, making sure each label has roughly the same number of opportunities to earn points.
- Open the Results tab and create a default result for tied or weakly expressed outcomes.
- Create a Result Page for Strategy: mode
Label, labelstrategy, calculationTotal Points, conditionis maximumor a range if you have already calculated thresholds. - Create equivalent pages for Operations, Communication, and Creative.
- In each result, insert the interpretation and a label details table sorted by descending points, with a limit of 4.
- Configure the email template: short result summary, links to relevant materials, and a reminder that the profile is only a guide.
- Publish the quiz on a separate test page using the QSM block or embed shortcode.
Verifying the Outcome
Run four control passes. In the first, choose Strategy answers. In the second, choose Operations. In the third, choose Communication. In the fourth, choose Creative. Each run should display the matching results page. Then do a mixed run: half Strategy, half Communication. If the default result appears, or one of the two profiles appears with text explaining the close second direction, that is normal. If an unexpected type appears, open the questions and check the labels.
After that, verify the label details table. It should sort by points or counts the way you intended. If the table displays empty values, check whether your result is built on options instead of labels, and whether the label slugs match the variables or shortcode. If the email does not arrive, do not start with Advanced Assessment. Check the QSM email settings, submit actions, and WordPress mail delivery first.
A Note on Recommendations
Add a next step for each profile. Strategy can link to a planning resource, Operations to a process checklist, Communication to an article about facilitation, and Creative to a set of exercises. The link should be useful, not salesy. The user should feel that the result gives them something actionable. That is what separates a good assessment from a quiz built only for entertainment.
Publishing the Quiz and Checking the Frontend
Once the logic works in the admin, you need to confirm that visitors will see the form and result correctly. QSM offers several output methods: shortcode in a page or post, widget, and QSM block in Gutenberg. For most modern sites, the QSM block is more convenient because the editor selects the quiz from a dropdown instead of manually copying a shortcode. Shortcode remains the universal option for the Classic Editor, widget areas, landing pages, or custom blocks.
The main publication rule is simple: do not place the same quiz shortcode twice on the same page. The QSM documentation explicitly warns that using the same Quiz/Survey Shortcode with the same ID on one URL can cause problems. If you need to show two forms, use different quiz IDs. If you want to repeat a button or link to the same test, send users to a separate page instead of embedding the form again.
Checking the Public Page
Open the page in a private browser window. Complete the quiz as a new user. Check the following:
- The form loads without JavaScript errors and is not hidden behind the theme's sticky header.
- Answer choices are clickable, Next and Submit buttons are visible, and required fields show clear error messages.
- After submission, the correct Result Page appears instead of a blank page or the default result without a clear reason.
- The labels table or pie chart stays within the container width on both desktop and mobile.
- Email is sent only when intended and does not include stray internal variables.
- A completion record appears in the QSM Results tab if the form settings are configured to save submissions.
If the site uses caching, JavaScript minification, or CSS optimization, run a separate test while logged out after publication. Some problems only show up for guests: cache may serve an older version of the page, a script may load too late, or style optimization may merge CSS in a way that makes buttons unreadable. Do not assume Advanced Assessment is calculating incorrectly until the form itself is confirmed to work properly on the public page.
Reviewing Results in the Admin
The QSM Results section shows submitted entries: quiz name, score, points, completion time, contact fields, and other data. For Advanced Assessment, this is a useful control layer. If a participant reports a strange result, find the submission, review the answers, and compare them with the labels. Sometimes it turns out the person really did choose answers that lead to that profile. Other times, you will find a methodology error: one answer was assigned to the wrong label.
If you need a deeper analysis of audience trends, consider the Reporting & Analysis add-on. It serves a different purpose from Advanced Assessment: Reporting & Analysis studies collected submissions and builds reporting, while Advanced Assessment assigns a personalized outcome to each participant. They can work well together, but they should not be treated as the same thing.
Safe CSS Adjustments for the Result Without Editing Plugin Files
Sometimes QSM Advanced Assessment works correctly but looks too plain: the distribution table feels cramped against the text, the recommendation block gets lost, or the retake button does not match the rest of the site. You can improve that without editing plugin or theme files. The foundation here is the official QSM documentation for Custom Style CSS, which lists the public classes used for the container and form.
Below is a small custom adjustment. It does not rely on hidden hooks, does not change PHP, and does not interfere with calculation. Its purpose is simply to separate the result block and table more cleanly inside a specific QSM form. Before applying it, inspect your actual page markup in the browser: QSM classes may vary depending on the quiz theme and the core renderer version.
/* Custom CSS adjustment for a QSM results page.
Basis: public QSM CSS classes documented in Editing Design Styles.
Insert into: the Style tab for the specific quiz, or the theme CSS area if the selector is limited to the quiz page. */
.qsm-quiz-container .qsm-results-page,
.mlw_qmn_quiz .qsm-results-page {
border: 1px solid #d9e2ec;
border-radius: 8px;
padding: 24px;
background: #ffffff;
}
.qsm-quiz-container table,
.mlw_qmn_quiz table {
width: 100%;
border-collapse: collapse;
margin-top: 16px;
}
.qsm-quiz-container th,
.qsm-quiz-container td,
.mlw_qmn_quiz th,
.mlw_qmn_quiz td {
padding: 10px 12px;
border-bottom: 1px solid #e6edf3;
text-align: left;
}
The check is straightforward: open the test results page and confirm that the result block is easier to read, the table still works on mobile width, and other QSM forms on the site have not changed unexpectedly. If the changes affect forms they should not, add a page-specific selector or remove the code. Rollback is simple: delete the CSS and save the style again. Do not edit QSM Advanced Assessment or QSM Core files, because those changes will be lost on update and will make maintenance harder.
If the QSM Style tab is using Custom mode, keep the documentation warning in mind: it can replace the standard CSS for a specific quiz or survey. So save your current settings first, test on a copy of the form, and only then move the changes into the live page.
How to Improve the Methodology After the First Real Runs
The first published assessment almost always needs editorial refinement. That is normal. The important thing is not to change the scale blindly after one subjective comment. First collect several test runs from people who understand the purpose of the assessment. Ask them not just whether they like the result, but which question felt ambiguous, where an answer choice did not match real behavior, and which result text felt too generic.
Then divide revisions into three groups. The first is question and answer wording. Those can often be improved without changing labels if the meaning stays the same. The second is label and point assignments. Those directly affect calculation, so every change needs to be validated with control runs. The third is Result Pages conditions. This is the most sensitive group: changing a threshold can redirect a large share of users into a different profile.
Checking for Methodological Bias
After you have some data, see whether one profile wins too often. The cause may be the audience, but more often it is the questions. For example, Strategy may sound more prestigious than Operations, and people may choose it not because it reflects how they work, but because the answer sounds "smarter." The fix is to make the options equally attractive. An Operations answer should not sound like "I just follow instructions." A better version is "I turn uncertainty into a clear process and carry it through to completion."
Also check the length of the answer choices. A longer answer often feels more thoughtful and gets more clicks. If one type is always described in more detail and another in a shorter form, the outcome will drift. QSM Advanced Assessment will honestly count the selected labels, but it will not correct for the psychological effect of the wording.
Handling Ties and Close Scores
If two profiles often appear close together, you do not have to force the system to pick a single winner. Sometimes it is better to create a mixed-profile results page or use the default result with a table. Dynamic conditions can compare values, but for most sites a simple explanation is enough: "If the second direction trails by only a few answers, consider both." You do not need to overengineer tie logic until the data shows you really need it.
Combining with Supporting Add-Ons
Advanced Assessment is responsible for calculating personalized outcomes. If you want to extend the workflow, other QSM add-ons may be useful alongside it. The Logic add-on helps show different follow-up questions depending on the answer. Reporting & Analysis helps you review aggregated data and audience trends. Email marketing integrations can move the user into the correct follow-up sequence. User Dashboard is useful if participants need to see past results and progress over time.
But each addition should have a clear responsibility boundary. Do not enable Logic just because it exists: branching makes label comparison harder if different participants answer different numbers of questions. Do not connect Reporting & Analysis if you do not plan to review reports regularly. Do not send sensitive profiles into a CRM without clear consent. A good add-on stack starts with the use case, not with the desire to turn everything on.
Relevant Product Video
For this guide, there is a highly relevant video on the topic: WordPress Personality Test Tutorial | QSM Advanced Assessment Guide. It is especially useful for the "QSM + Advanced Assessment + personality quiz" combination: the developer's preview notes that the video covers assigning labels to each answer and creating personalized results pages. Use the video as a visual companion to the sections on labels and results pages, not as a substitute for validating your own conditions.
After watching, it helps to repeat the process on a copy of your form: create labels, assign them to several answers, add results pages, and take the quiz with a pre-planned expected outcome. If your use case is not a personality quiz but an educational category check or product recommendation, apply the underlying principle from the video rather than the topic of the sample questions: answer -> label -> condition -> result.
Troubleshooting: Why the Result Does Not Match Expectations
Issues in QSM Advanced Assessment usually look the same on the surface: the participant completes the form but gets the "wrong" result. The cause may be installation, labels, points, result conditions, form publishing, cache, or email settings. The symptom-based breakdown below helps narrow it down. Start with a simple mini test instead of rewriting every results page.
The Form Behaves Like a Standard QSM Quiz, but Advanced Assessment Does Not Affect the Result
Symptom: questions submit successfully, the basic result appears, but conditions based on labels or options do not trigger. One likely cause is that the add-on is active in WordPress, but assessment is not enabled for the specific form. Open the quiz or survey, go to the add-ons dropdown, select Advanced Assessment, and confirm that Assess this form is checked. After saving, run the short test again.
If the checkbox is already enabled, check whether you are editing a copy of the form while the page is publishing a different quiz ID. This is a common admin mistake: the conditions are configured in a draft, but the shortcode on the page points to the older form. The fix is to replace the shortcode or select the correct quiz in the QSM block.
The Default Result Always Appears
Symptom: regardless of the answers, the user always sees the fallback page. Possible causes include conditions that are too narrow, answers with no labels assigned, unsaved results pages, a quiz in draft mode, or the wrong calculation type. The QSM Results Page documentation also notes that results are not recorded or displayed correctly when the quiz or survey is in draft mode.
Check this by creating a temporary simple condition for one label using is maximum, then take the quiz while selecting only answers mapped to that label. If the result works, the problem is in your complex ranges. If it does not, go back to the questions and review the label assignments.
The Wrong Label Wins
Symptom: the participant chooses answers from one profile but gets another. Possible causes include some answers being assigned to the wrong label, Label Points being enabled with unexpected values, a multiple response question contributing too much weight, or one profile appearing in more questions than the others. The fix is to open your questions x labels matrix and recalculate the available point paths.
If you are using option-based assessment, check the order of the answers. In this mode, the position of the option matters more than the wording. If an editor reordered the answers in one question, Option 1 may now represent a different type.
The Label Details Table Is Empty or Does Not Show the Expected Values
Symptom: the results page opens, but label count, label point, or percentage variables do not show the expected data. One possible cause is that the result is configured around options, while the variables are designed for label-based conditions. The Advanced Assessment documentation explicitly draws that distinction. Check whether labels are assigned to answers, whether the correct slugs are used in the variables, and whether the results page still contains an old shortcode tied to a different label.
The Result Email Does Not Arrive
Symptom: the result appears on the page, but no email reaches the participant or the administrator. Do not start with Advanced Assessment. First check the QSM Emails tab: is a recipient set, has %USER_EMAIL% been removed, are email notification submit actions enabled, and does the contact form include an email field? Then check WordPress mail delivery through SMTP or a send log if one is installed on the site. If the email arrives but variables are empty, then go back to labels and result variables.
The Result Breaks After Enabling Cache or Optimization
Symptom: everything works in the admin and preview, but a guest user sees an old result, a frozen form, or inactive buttons. Test the page without cache, clear both page cache and object cache, and temporarily disable delayed JavaScript loading for the quiz page. If the page contains two identical shortcodes for the same quiz ID, remove one. Once you find the cause, exclude the quiz page from aggressive optimization or create targeted cache rules for it.
The Result Display Conflicts with the Theme
Symptom: the labels table spills outside the container, buttons are hard to read, and required field errors are barely visible. Start by checking the default QSM style. Then add a limited CSS adjustment through the Style tab or your theme CSS. Do not edit plugin files. If the problem appeared suddenly after a theme change, use the approach described in the Common Theme Conflict Fixes documentation: isolate the conflict, then review the theme, optimization plugins, and custom CSS.
Complex Conditions: When a Simple Maximum Is No Longer Enough
For an initial launch, it is usually best to keep the logic simple: whichever label has the highest point total wins, so show the matching result. But QSM Advanced Assessment includes a more nuanced layer that becomes useful once the basic workflow is validated. This means result conditions where you can compare values across labels, options, and categories, including through template variables. The Results Conditions for Advanced Assessment documentation shows examples such as comparing label points to category points, comparing two category scores, comparing two labels, and checking option-based values against label percentages.
Not everyone needs this. If your use case is a light "what type are you" quiz, extra complexity may only confuse the editor. But for learning assessments, career guidance, internal selection, consultation questionnaires, and product recommendation quizzes, advanced conditions can help avoid results that are too crude. For example, a participant may score highest on Strategy, but if Communication is only slightly behind and the "Team Work" category is above average, the result "strategist-coordinator" may be more accurate than simply "strategist."
Example of a Two-Layer Condition
Imagine that the career profiler needs to distinguish between an "analytical strategist" and a "communication strategist." Both participants score high on Strategy, but the first has a strong Analysis category and the second has a strong Communication category. In a basic results page, both would see Strategy. In an advanced setup, you could create two outcomes: Strategy + Analysis and Strategy + Communication. The conditions need to be written so they do not conflict with each other.
A practical sequence looks like this:
- First create the base pages for Strategy, Operations, Communication, and Creative.
- Add question categories only if they already play a real role in the methodology, not just to power a condition.
- Create a separate mixed-profile results page only where it actually helps the user.
- In the condition, check both the leading label and an additional category value.
- Keep a default result for cases where values are close but no mixed-profile rule matches.
The main risk is condition order and overlap. If two results pages can both match, QSM will show the one that wins according to the template selection logic in the editor. That is why complex rules should be documented. Next to each results page in your working methodology file, write a plain-language explanation such as: "Show this if Strategy is leading and Analysis is higher than Communication." Without that, maintaining the assessment a few weeks later becomes difficult.
When Not to Add Complexity
Do not use dynamic condition variables if you have fewer data points than the interpretation requires. Three questions cannot reliably separate four profiles and two categories. Do not compare values built from different numbers of questions. If the Analysis category contains 8 questions and Communication contains only 3, comparing total points is unfair. In that case, it is better to compare percentages if your structure and the documentation for the selected mode support it, or to rebalance the number of questions.
Also, do not substitute math for methodology. A complex condition does not make a test more accurate by itself. It only expresses a rule you have already thought through. If you cannot explain the rule in plain language, it should not go into Result Pages. A good outcome should be testable: the author should be able to take the quiz using a known answer pattern and predict in advance which page will appear.
Testing Complex Conditions
For advanced logic, create a set of control runs. Each run should not be just an "approximate user." It should be a concrete list of answers with an expected outcome. Store those scenarios in your working document. For example: "Scenario A: 8 Strategy choices, 2 Communication choices, high Analysis category - should show Strategy + Analysis." After every change to labels, points, or categories, run those scenarios again.
If the result changes unexpectedly, do not rewrite the condition blindly. First determine which value changed: label points, label count, category points, or correct percentage. Then review the question that contributed the unexpected change. This process is similar to code testing: you are not just clicking through the form, you are validating the chain of input -> product logic -> output. That is especially important in QSM Advanced Assessment because the interface is visual, but the error often lives in invisible labels.
Data, Privacy, and Responsibility for the Result
Any assessment collects answers from real people. Even when the questions seem harmless, the result may reveal a great deal about a participant's preferences, skills, goals, doubts, or professional situation. QSM Advanced Assessment makes the outcome more personal, which raises the bar for wording, data storage, and email practices. This is not legal advice, but there is a practical minimum worth setting up before publication.
Start by deciding what data you actually need. If the result can be shown without collecting an email address, do not force the user to provide one just to complete the quiz. If email is needed to send the interpretation, explain that next to the contact form. If you collect a name, company, phone number, or freeform comment, check where those fields appear in QSM Results and which add-ons are required to export custom contact fields. The Quiz Results documentation notes that contact fields are visible in the Results tab by default, while custom contact fields may require the Export Result add-on for viewing.
The second layer is the result wording itself. Do not promise accuracy your methodology does not support. For career aptitude, it is better to say "your answers suggest a tendency toward..." than "only this profession is right for you." For wellness or mental health topics, avoid diagnostic phrasing. For a product recommendation quiz, note that the recommendation is based on the submitted answers and may not account for every individual condition. Personalization builds trust only when it does not pretend to be absolute truth.
Email and Sensitive Conclusions
The QSM Emails tab lets you send the result to the participant. That is convenient, but an email result can be forwarded, land in a shared inbox, or remain stored inside a mailing platform. If the assessment touches on sensitive topics, consider sending a shorter message: "Your result is ready, return to the results page," or "Below is a brief profile summary without the full answer details." Public entertainment quizzes can be more relaxed, but even then, there is rarely a good reason to send the full list of answers unless it is truly needed.
If emails also go to an administrator, decide whether that person actually needs every participant's personalized result. For marketing segmentation, a profile label and contact data may be enough. For an educational test, score and weak categories may be relevant. For an internal HR questionnaire, you may need a separate access policy. QSM Advanced Assessment gives you the technical capability, but it does not decide who should be allowed to see the data.
Storing and Deleting Results
The QSM Results section allows you to view and delete entries. Before launch, agree on an internal rule: how long submissions should be stored, who has access to WordPress admin, who can export data, and how deletion requests will be handled. Even on a small site, these rules protect the project from disorder. Once the assessment becomes popular, it becomes much harder to make sense of old submissions manually.
If you use analytics or reporting add-ons, review what data they aggregate. Anonymized label statistics are usually less sensitive than specific answers tied to a name and email address. For team reporting, it is often enough to see profile distribution and completion trends without exposing individual responses.
Update Security
The QSM Core and Advanced Assessment changelogs show regular security, patch, and enhancement updates. For a site owner, that is a practical signal: do not leave the add-on outdated, especially if the assessment collects contact data and displays result templates. Before updating, create a site backup and then test a quiz copy. After updating, rerun your control scenarios. If the changelog mentions result conditions, template variables, chart uploads, or validation, review those areas more carefully.
Do not install versions from questionable sources. In addition to the legal and ethical issues, those packages may stop receiving updates and may contain modified code. That is especially risky for a plugin handling user answers and email delivery. This final article does not need to list prohibited site types, but the practical takeaway is simple: use the official source and a normal update path.
Pre-Launch Review Before Publishing on the Live Site
Before sending traffic to an assessment page, do both a technical and an editorial review. QSM Advanced Assessment may be configured correctly on paper while still creating a weak user experience: questions may feel repetitive, the result may be too generic, the labels table may not be explained, the email may just repeat the page without adding value, and the default result may feel like an error. A pre-launch review helps catch those problems before the first real participants arrive.
Review the Question Wording
Read all questions out loud in sequence. If several questions measure the same trait, combine them or rewrite them. If the answer choices differ not in meaning but in how attractive they sound, rebalance them. If one profile sounds prestigious and another sounds like a compromise, the result will be skewed. Good options should feel equally valid: each one should describe a normal behavioral strategy, not a "right" and a "wrong" choice.
Check for double statements in the questions. For example, "I make decisions quickly and like working with people" mixes decision speed with communication. A participant may agree with one part and not the other. That is risky in Advanced Assessment: one answer receives a label, but its meaning splits across two dimensions. It is better to turn that into two separate questions.
Review the Scale
Build the final labels and points matrix. For each label, calculate the maximum possible number of points. If the difference is large, revise the questions or point values. For multiple response questions, calculate the maximum contribution separately. If one question can contribute 9 points while a normal single-choice question contributes 3, it should be methodologically more important. Otherwise, that is a bias.
Review every result condition. Make sure each primary profile has its own page, and that the default result includes a useful explanation. If you use ranges, check for gaps. For example, one result may trigger for 0 to 20, another for 22 to 40, leaving 21 with no page at all. If you use maximum, test ties. If you use dynamic variables, run the control scenarios.
Review the Interface
Open the page on desktop and on mobile width. QSM forms are responsive, but the site theme, custom CSS, and results HTML can still break the layout. Check spacing between answer choices, the selected answer state, error visibility, the width of the labels table, pie chart display, the submit button, and retake behavior if retakes are allowed. If the result contains a lot of HTML, test it on an actual phone, not just in a narrow desktop browser window.
If you are using the QSM block, make sure the correct quiz is selected. If you are using a shortcode, verify the ID. If the assessment is embedded inside a page builder, check that the builder is not duplicating the shortcode in a hidden mobile section. This happens on pages where desktop and mobile versions are built as separate blocks. For QSM, that can look like "one quiz shown twice on the page" even if the user visually sees only one form.
Review Emails and Admin Data
Run a test with a real email address. Check the subject line, sender, personalized variables, results link, and the absence of empty placeholders. Then check the admin email if it is enabled. If emails are not needed, disable them deliberately instead of leaving an empty template in place. In QSM, you can remove the user email template, remove %USER_EMAIL%, or disable the notification submit action. Choose the method that fits your form setup.
After submission, open QSM Results and find the entry. Confirm that the stored data is sufficient for future support: the quiz name is clear, contact fields are visible, the score or points do not look random, and the result can be tied back to the submission. If you need more data, solve that before launch, because older submissions are not always easy to reconstruct in a new format.
Review the Editorial Value
The final question is simple: does the result help the user act? If the page says only "you are Strategy," it is weak. Add an explanation, characteristic traits, profile risks, a next step, and a useful resource. If the output includes a table, explain how to read it. If the user has close secondary directions, tell them what that means. If the assessment recommends a product, explain why that option was chosen and when it makes sense to look at an alternative.
Only after that review should you move the page from testing to live and send real traffic to it. If you are ready to continue, you can move on to the download section below and get the product installation file after the methodology, content, and test page are already prepared.
Questions About Setup and Limitations
Can I use QSM Advanced Assessment without base QSM?
No. This is an add-on for Quiz and Survey Master, so you need an active QSM Core plugin first. The Advanced Assessment documentation also lists QSM Core 9.0 or higher as a requirement. If the main plugin is missing or outdated, the assessment setup will not be reliable.
What should I choose for a personality quiz: options or labels?
For a short quiz with identical answer order across all questions, options can work. For a stable personality quiz, labels are the better choice because they do not depend on answer position and give you access to label variables, percentages, point tables, and more detailed interpretation.
Why are Advanced Assessment variables not showing on the results page?
Most often, the result is built on options while the variables belong to label-based logic, or the variable uses the wrong label slug. Check that labels are assigned to the answers, assessment is enabled for the form, and the slug in the variable matches the actual label slug.
Can one answer have multiple labels?
Yes. The documentation describes support for multiple labels on an answer option. If you need different point amounts for each label, enable Label Points in the add-on settings for the form and assign separate values in the question editor.
Which question types are supported by the add-on?
The Advanced Assessment documentation lists multiple-choice questions, multiple-choice horizontal, multiple response, and multiple response horizontal. If you use other types, do not assume they participate in Advanced Assessment until you have tested them in a sample form and checked the current documentation.
What should I do with tied results?
Start with the methodology decision: do you need a mixed profile, a default result, or a priority rule for one direction? For short quizzes, it is often better to show label distribution and mention the close second profile. Do not try to hide ties if they are useful to the user.
Can I treat the result as a medical or psychological conclusion?
Technically, the add-on can calculate labels and points, but it does not validate the content of the assessment. For sensitive topics, use careful wording, legally appropriate disclaimers, and a reviewed methodology. QSM Advanced Assessment is a personalization engine for results, not a guarantee of scientific validity.
Do I need to buy Reporting & Analysis together with Advanced Assessment?
Not necessarily. Advanced Assessment handles the participant's personalized result. Reporting & Analysis is needed if you want to analyze accumulated submissions, build charts, and review audience trends. For a first implementation, Advanced Assessment plus manual result review is enough.
When QSM Advanced Assessment Is the Right Choice
QSM Advanced Assessment is worth using when you want to turn a standard WordPress quiz into more than just a list of questions and make it a clear personalized outcome system. Its strengths are labels, separate label points, conditions based on options, labels, and categories, variables for results and email, and the ability to show answer distribution in a table or chart. In the hands of a careful author, that turns QSM into a practical tool for profilers, recommendations, learning diagnostics, and audience segmentation.
Before launching on a live site, verify four things: QSM Core and the add-on are active, the Assess this form checkbox is enabled for the correct form, labels and points are assigned evenly, and the results pages have clear conditions plus a meaningful default result. Then run the quiz through at least several control scenarios and test the public page while logged out.
If you only need a simple knowledge quiz, standard QSM may be enough. If you need a marketing funnel with a visual builder and an opt-in gate, compare alternatives. But if your goal is deep assessment inside QSM itself, where answers are turned into labels, scores, category checks, and personalized interpretation, QSM Advanced Assessment covers that use case directly and without custom code.
After validating everything on a test page, you can download the installation file, install it on the prepared site, and begin with a short copy of the form. That approach is safer than moving a complex assessment straight onto a live page: you get to see the mechanics, understand the conditions, and then expand the setup into a fully developed tool for your audience.


