Results and Outcomes

After a respondent completes a quiz, WittyForm displays a result screen. This guide covers how to configure result screens, personality outcomes, pass/fail thresholds, and post-submission behavior.

Result screen configuration

Every quiz has a default result screen. You can customize its content in the quiz builder under Results → Result Screen.

Scored quiz results

Scored quizzes use a single result screen for everyone. Turn on showScore to display the score and set a passingScore threshold to mark each result as a pass or a fail (see Pass/fail thresholds below). If you want every respondent to see a different result message based on their answers, use a personality quiz with multiple outcomes instead.

Personality outcome setup

For personality quizzes, results are determined by trait accumulation rather than right/wrong scoring.

Defining outcomes

{
  "outcomes": [
    {
      "id": "explorer",
      "title": "The Explorer",
      "description": "You thrive on new experiences and love discovering the unknown.",
      "image": "/outcomes/explorer.png",
      "traits": { "curiosity": 0.8, "adventure": 0.9, "openness": 0.7 }
    },
    {
      "id": "analyst",
      "title": "The Analyst",
      "description": "You approach problems with logic and love diving into data.",
      "image": "/outcomes/analyst.png",
      "traits": { "logic": 0.9, "detail": 0.8, "patience": 0.7 }
    }
  ]
}

Assigning trait weights to answers

Each answer choice maps to one or more traits. When a respondent selects an answer, the associated trait values are added to their running totals. The outcome with the highest cumulative trait match wins.

// Question answer with trait weights
{
  "text": "How do you spend a free Saturday?",
  "options": [
    {
      "text": "Hiking a new trail",
      "traits": { "curiosity": 3, "adventure": 5 }
    },
    {
      "text": "Reading a research paper",
      "traits": { "logic": 4, "detail": 3 }
    }
  ]
}

Pass/fail thresholds and retakes

For scored quizzes, set a passing threshold to categorize results as pass or fail, and decide whether respondents can try again.

Showing correct answers post-submission

Enable showCorrectAnswers on your Result Screen block to let respondents review which questions they got right and wrong after submitting.

When the toggle is off, respondents only see their aggregate score and result message. No correct-answer data is returned from the API, so there is no way to cheat by inspecting network traffic.

Redirecting after the quiz

Instead of (or after) showing a result screen, you can send every respondent to a custom URL when they finish. Set a single redirect destination in the quiz settings.

Leave redirectUrl empty to keep respondents on the WittyForm result screen. If you want to point people to different destinations depending on their result, build a personality quiz with one outcome per destination instead.