> ## Documentation Index
> Fetch the complete documentation index at: https://help.weavely.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Match Quiz

> Use Weavely's AI to build a quiz that weights each answer and sorts respondents into categories. Ideal for personality quizzes and product-match finders.

<span className="weavely-jsonld" hidden>
  {`{
      "@context": "https://schema.org",
      "@graph": [
        {
          "@type": "WebPage",
          "@id": "https://help.weavely.ai/features/match-quiz",
          "url": "https://help.weavely.ai/features/match-quiz",
          "name": "Match Quiz",
          "description": "Use Weavely's AI to build a quiz that weights each answer and sorts respondents into categories. Ideal for personality quizzes and product-match finders.",
          "inLanguage": "en",
          "publisher": { "@id": "https://www.weavely.ai/#org" }
        },
        {
          "@type": "TechArticle",
          "@id": "https://help.weavely.ai/features/match-quiz#article",
          "headline": "Match Quiz",
          "description": "Use Weavely's AI to build a quiz that weights each answer and sorts respondents into categories. Ideal for personality quizzes and product-match finders.",
          "inLanguage": "en",
          "mainEntityOfPage": { "@id": "https://help.weavely.ai/features/match-quiz" },
          "author": { "@id": "https://www.weavely.ai/#org" },
          "publisher": { "@id": "https://www.weavely.ai/#org" }
        },
        {
          "@type": "VideoObject",
          "@id": "https://help.weavely.ai/features/match-quiz#video",
          "name": "How to Build Lead Generation Quizzes & Assessments in Weavely (Full Walkthrough)",
          "description": "How to build a lead qualification form and a match quiz with AI, start to finish, using Weavely. In this walkthrough I build two kinds of scored forms from a single prompt, no manual setup: Lead qualification form: respondents answer a few questions, each gets a single score, and they're sorted into cold, warm, or hot leads with a different ending depending on the score. I build it around a sandal-shop example and capture the respondent's email too. Match quiz: instead of one score, each answer carries weights that assign people to a category based on how they respond think personality quizzes or 'which product should you buy' finders for an e-commerce store. (Yes, there's a Harry Potter houses demo.) You'll also see how Weavely's AI writes the questions and wires up all the scoring automatically, how to fine-tune the scores, outcomes and endings by hand, and how to collapse outcome-based endings into a single score when that's all you need.",
          "url": "https://youtu.be/BcgQHVZDkcA",
          "contentUrl": "https://www.youtube.com/watch?v=BcgQHVZDkcA",
          "embedUrl": "https://www.youtube.com/embed/BcgQHVZDkcA",
          "duration": "PT7M5S",
          "uploadDate": "2026-06-02",
          "thumbnailUrl": [
            "https://i.ytimg.com/vi/BcgQHVZDkcA/maxresdefault.jpg"
          ],
          "publisher": { "@id": "https://www.weavely.ai/#org" },
          "potentialAction": {
            "@type": "WatchAction",
            "target": "https://youtu.be/BcgQHVZDkcA"
          }
        },
        {
          "@type": "Organization",
          "@id": "https://www.weavely.ai/#org",
          "name": "Weavely",
          "url": "https://www.weavely.ai"
        }
      ]
      }`}
</span>

<iframe src="https://www.youtube.com/embed/BcgQHVZDkcA" title="YouTube video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

A match quiz sorts respondents into **categories** based on their answers. Instead of one score, each answer carries **weights** toward different outcomes, and the outcome with the most points is the one the respondent sees. It's the format behind personality quizzes and "which product should you buy" finders.

<Note>
  Want a single score per respondent instead (e.g. cold, warm, hot leads)? See [Build a lead qualification form](/features/lead-qualification).
</Note>

## Steps

<Steps>
  <Step title="Describe the quiz you want">
    Describe the quiz and the categories people should be sorted into. The more specific the prompt, the better the questions and outcomes.

    ```text theme={null}
    I want a personality quiz which assigns people to one of the
    four Harry Potter houses based on their traits.
    ```

    Another common use is an e-commerce product finder that recommends a different product depending on the answers. Press **Generate form**.
  </Step>

  <Step title="Review the questions and outcomes">
    Weavely generates the questions *and* the outcomes, in this case, one outcome per Harry Potter house, then wires up the weighting.

    <Frame>
      <img src="https://mintcdn.com/weavelyai/lnwsSFxrw5ZSTbQZ/images/Screenshot-2026-06-02-at-11.30.34.webp?fit=max&auto=format&n=lnwsSFxrw5ZSTbQZ&q=85&s=8027b2fb6daa201b08172ab1d5aa52ef" alt="Generated match quiz questions and outcomes in Weavely AI" width="3004" height="1470" data-path="images/Screenshot-2026-06-02-at-11.30.34.webp" />
    </Frame>
  </Step>

  <Step title="Check how the weighting is wired up">
    Open **Settings → Match quiz**. Unlike a lead qualification form, there's no single score per answer. Instead, each answer carries a **weight** toward one or more outcomes. For example, "bravery" might be a point for Gryffindor, while "ambition" is a point for Slytherin. A single answer can carry weight toward several outcomes at once, bravery could add a point to both Gryffindor *and* Hufflepuff.

    <Frame>
      <img src="https://mintcdn.com/weavelyai/lnwsSFxrw5ZSTbQZ/images/Screenshot-2026-06-02-at-11.31.28.webp?fit=max&auto=format&n=lnwsSFxrw5ZSTbQZ&q=85&s=5cf0248664333a3f9dd3592cfe7f0949" alt="Match quiz weighting settings in Weavely AI" width="3000" height="1474" data-path="images/Screenshot-2026-06-02-at-11.31.28.webp" />
    </Frame>

    <Tip>
      Weavely's AI assigns weights for every question and answer automatically. Adjust or add weights to fine-tune which answers point to which outcome.
    </Tip>
  </Step>

  <Step title="Publish and test">
    Publish the form and fill it in. As a respondent moves through the quiz, they accumulate points toward each outcome, and the highest-scoring outcome is shown at the end.
  </Step>

  <Step title="Review responses">
    <Frame>
      <img src="https://mintcdn.com/weavelyai/lnwsSFxrw5ZSTbQZ/images/Screenshot-2026-06-02-at-11.32.25.webp?fit=max&auto=format&n=lnwsSFxrw5ZSTbQZ&q=85&s=46d3039f2bced99edc8fca6c843a026f" alt="Screenshot showing results of a match quiz in Weavely AI" width="2998" height="1468" data-path="images/Screenshot-2026-06-02-at-11.32.25.webp" />
    </Frame>

    In **Results**, you'll see each respondent's answers and the outcome they were matched to.
  </Step>
</Steps>