Modes de formulaire

Overview

NueForm supports four distinct form modes, each designed for a different use case. The form mode is set via the mode field on the Form model and determines how responses are scored, how feedback is presented, and how end screens are selected.

Choosing the right mode affects which question-level properties become available and how the final submission results are calculated.

Standard Mode

Mode value: standard

Standard mode is the default for all new forms. It is designed for surveys, contact forms, feedback collection, registration forms, and any scenario where scoring is not needed.

Behavior

• No scoring or grading of any kind.
• Responses are collected and stored as-is.
• End screens are purely display-based -- there is no conditional routing based on scores or outcomes.
• The default thank-you screen is shown after submission.

When to Use

• Contact forms and lead capture
• Customer satisfaction surveys
• Event registration
• Feedback forms
• Any general-purpose data collection

Knowledge Quiz Mode

Mode value: knowledge_quiz

Knowledge quiz mode is designed for quizzes, tests, exams, and assessments where questions have correct and incorrect answers. Each scorable question can define one or more correct answers, and the respondent receives a score based on how many they answered correctly.

Scoring Mechanics

Each scorable question has a correctAnswer property that identifies the correct response. When the respondent submits, NueForm compares their answers against the correct answers and calculates the results:

Scorable Question Types

Only certain question types participate in knowledge quiz scoring:

• Multiple Choice
• Dropdown
• Picture Choice
• Yes/No
• Rating
• Opinion Scale

Non-scorable question types (such as short text, long text, file upload, etc.) are still included in the form but do not contribute to the quiz score.

Quiz Feedback

Knowledge quiz mode supports real-time feedback after each question. When enabled, the respondent immediately sees whether their answer was correct or incorrect before advancing to the next question.

End Screens with Score Ranges

In knowledge quiz mode, you can create multiple end screens with scoreRange properties to conditionally display different results based on the respondent's performance. Each end screen specifies a minimum and maximum score range, and the respondent is routed to the end screen whose range contains their final score.

Example:

• End Screen A: scoreRange 8-10 -- "Excellent! You aced it!"
• End Screen B: scoreRange 5-7 -- "Good job! You passed."
• End Screen C: scoreRange 0-4 -- "Keep studying and try again."

When to Use

• Educational quizzes and exams
• Training assessments
• Trivia games
• Certification tests
• Knowledge checks

Lead Qualification Mode

Mode value: lead_qualification

Lead qualification mode is designed for lead scoring, personality assessments, and forms where different answer choices carry different point values. Rather than a single correct answer, each choice is assigned a numeric score that accumulates as the respondent progresses.

Scoring Mechanics

Each choice in a scorable question has a points property that defines its numeric value. As the respondent selects answers, points accumulate into a total score.

Configuring Choice Points

In the question editor, each choice option includes a point value field when the form is in lead qualification mode. For example:

• "Very interested" -- 10 points
• "Somewhat interested" -- 5 points
• "Not interested" -- 0 points

End Screens with Score Ranges

Each end screen can define a scoreRange with min and max values. After submission, NueForm matches the respondent's total score to the appropriate end screen:

Example:

• End Screen A: scoreRange 30-50 -- "You're a hot lead! A sales rep will contact you shortly."
• End Screen B: scoreRange 15-29 -- "Thanks for your interest. We'll send you more information."
• End Screen C: scoreRange 0-14 -- "Thanks for your time. Here are some resources to learn more."

When to Use

• Sales lead qualification
• Personality assessments
• Risk assessments
• Recommendation engines
• Priority scoring

Match Quiz Mode

Mode value: match_quiz

Match quiz mode is designed for outcome-based quizzes where each answer maps to a specific outcome, and the outcome with the most matches determines the result. This is the classic "Which character are you?" or "What's your style?" quiz format.

Scoring Mechanics

Match quiz mode uses a tally system rather than numeric points:

1. Quiz outcomes are defined in the form's quizSettings using the quizOutcomes array. Each outcome corresponds to an end screen.
2. Each choice in a scorable question has a matchOutcome property that maps it to one of the defined outcomes.
3. As the respondent answers questions, tallies accumulate for each outcome.
4. After submission, the outcome with the highest tally determines which end screen is displayed.

Configuring Outcomes

Outcomes are defined at the form level in quizSettings.quizOutcomes. Each outcome has a name and corresponds to an end screen. In the question editor, each choice is mapped to an outcome via its matchOutcome property.

Example:

Outcomes: "Explorer", "Planner", "Socializer"

• Question: "How do you prefer to spend weekends?"
  • "Hiking and adventures" -- maps to "Explorer"
  • "Organizing and planning the week ahead" -- maps to "Planner"
  • "Meeting up with friends" -- maps to "Socializer"

After all questions are answered, the outcome with the highest tally wins. If there is a tie, the first outcome in the quizOutcomes array takes precedence.

When to Use

• Personality quizzes ("Which character are you?")
• Style or preference matching
• Product recommendation quizzes
• Career aptitude assessments
• "What type of X are you?" content

Quiz Settings

Quiz-level settings are stored in the form's quizSettings JSON field. These settings apply globally to the form and control feedback behavior.

Scorable Question Types Reference

The following question types participate in scoring across all quiz modes (knowledge quiz, lead qualification, and match quiz):

All other question types (short text, long text, email, file upload, date, etc.) do not participate in scoring but can still be included in the form for data collection purposes.

Setting the Form Mode

The form mode is configured in the Form Settings panel of the builder:

1. Open the form in the builder.
2. Navigate to Settings.
3. Under Form Mode, select one of the four modes.
4. Configure mode-specific settings (quiz settings, outcomes, etc.) as needed.
5. For each scorable question, configure the scoring properties (correct answers, choice points, or outcome mappings) in the question editor.

Comparing Modes