> ## Documentation Index
> Fetch the complete documentation index at: https://fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Lead Quiz with Fillout

> Fillout’s advanced logic and email notification features make it possible for you to make fun and personalized form outputs, like outcome quizzes. 

export const SupportBanner = () => {
  const titleId = React.useId();
  return <div className="support-banner" role="region" aria-labelledby={titleId}>
      <span className="support-banner__ring support-banner__ring--outer" aria-hidden="true" />
      <span className="support-banner__ring support-banner__ring--middle" aria-hidden="true" />
      <span className="support-banner__ring support-banner__ring--inner" aria-hidden="true" />
      <span className="support-banner__ring support-banner__ring--center" aria-hidden="true" />

      <div className="support-banner__content">
        <div className="support-banner__title" id={titleId} role="heading" aria-level="2">Still have questions?</div>

        <div className="support-banner__copy">
          <span className="support-banner__line">Our team is happy to help. Start a live chat using the</span>
          <span className="support-banner__line">
            chat bubble <span className="support-banner__chat-icon" aria-hidden="true" /> in the bottom right, or email us at
          </span>
          <span className="support-banner__line">
            <a href="mailto:support@fillout.com">support{'@'}fillout.com</a>
          </span>
        </div>

        <a className="support-banner__cta" href="mailto:support@fillout.com">Contact us</a>
      </div>
    </div>;
};

## Overview

Lead quizzes are a reliable way to collect relevant contacts for your sales or marketing efforts. They work by asking leads a series of questions and generating a personalized scorecard or recommendation based on the answers.

## How to build a lead quiz

<Steps>
  <Step title="Switch to Quiz mode">
    Open an existing form or create a [new one](https://build.fillout.com/home/quizzes). Click the `gear icon` <Icon icon="gear-complex" /> on the upper right area.

    <img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/3ZcO_yEJK-WTjJHC/images/Screenshot2025-10-15at4.55.39PM.png?fit=max&auto=format&n=3ZcO_yEJK-WTjJHC&q=85&s=7bfecd360dad8bab4d698f1876498f80" alt="Screenshot 2025-10-15 at 4.55.39 PM.png" title="Screenshot 2025-10-15 at 4.55.39 PM.png" style={{ width:"34%" }} width="730" height="137" data-path="images/Screenshot2025-10-15at4.55.39PM.png" />

    Click `Quiz mode` in the left-hand panel to toggle the `Quiz mode enabled` switch.

    <img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/3ZcO_yEJK-WTjJHC/images/Screenshot2025-10-15at4.55.53PM.png?fit=max&auto=format&n=3ZcO_yEJK-WTjJHC&q=85&s=e0d9b51e8474146a5f436a725d945617" alt="Screenshot 2025-10-15 at 4.55.53 PM.png" width="2500" height="820" data-path="images/Screenshot2025-10-15at4.55.53PM.png" />

    <Warning>
      Disable the **Show correct answers after each page** feature to ensure results are only accessible via respondent emails and custom end pages.
    </Warning>
  </Step>

  <Step title="Add an email field and quiz questions">
    Go back to the form editor and add an `Email input` field followed by your preferred quiz question fields.

    <img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/KKmYfTaGUE6kYImk/images/Screenshot2025-10-15at5.32.47PM.png?fit=max&auto=format&n=KKmYfTaGUE6kYImk&q=85&s=fa366b1e8f8ddc7bf0a0a0fee8ec10a8" alt="Screenshot 2025-10-15 at 5.32.47 PM.png" width="2567" height="1436" data-path="images/Screenshot2025-10-15at5.32.47PM.png" />

    <Tip>
      Rename each page as you add fields to make it easier to find them when setting up conditions by clicking <Icon icon="ellipsis-vertical" />.
    </Tip>
  </Step>

  <Step title="Choose correct answers and score values">
    After adding a quiz question or field to a page, click it followed by the `graduation cap icon` <Icon icon="graduation-cap" iconType="solid" /> to open the answer key window.

    <img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/KKmYfTaGUE6kYImk/images/Screenshot2025-10-15at5.38.31PM.png?fit=max&auto=format&n=KKmYfTaGUE6kYImk&q=85&s=d0328aeacd7001ac820a337f55f7652e" alt="Screenshot 2025-10-15 at 5.38.31 PM.png" width="2569" height="1435" data-path="images/Screenshot2025-10-15at5.38.31PM.png" />

    Add a **tick mark** **✓** next to each correct answer and provide a **Score** value.

    <img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/3ZcO_yEJK-WTjJHC/images/Screenshot2025-10-15at5.01.31PM.png?fit=max&auto=format&n=3ZcO_yEJK-WTjJHC&q=85&s=dd03b16ea642597c9f79407415b95314" alt="Screenshot 2025-10-15 at 5.01.31 PM.png" title="Screenshot 2025-10-15 at 5.01.31 PM.png" style={{ width:"57%" }} width="935" height="883" data-path="images/Screenshot2025-10-15at5.01.31PM.png" />
  </Step>

  <Step title="Customize a quiz’s ending page(s)">
    By default, [ending pages](/ending-page) for quizzes will calculate and display each respondent’s total score. To hide this, click the `gear icon`<Icon icon="gear-complex" iconType="solid" /> and disable `Show quiz score`.

    <img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/KKmYfTaGUE6kYImk/images/Screenshot2025-10-15at5.40.16PM.png?fit=max&auto=format&n=KKmYfTaGUE6kYImk&q=85&s=82034020033ac5a77a89b5970f4e76cd" alt="Screenshot 2025-10-15 at 5.40.16 PM.png" width="2570" height="1432" data-path="images/Screenshot2025-10-15at5.40.16PM.png" />
  </Step>
</Steps>

### Show custom messages

For quizzes without right or wrong answers (e.g. "Which product is right for you?"), you can show specific text or media based on the respondent's answers.

<img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/3ZcO_yEJK-WTjJHC/images/Screenshot2025-10-15at5.21.46PM.png?fit=max&auto=format&n=3ZcO_yEJK-WTjJHC&q=85&s=bf52b7171ecb465c354843725a81dd2d" alt="Screenshot 2025-10-15 at 5.21.46 PM.png" width="2568" height="1437" data-path="images/Screenshot2025-10-15at5.21.46PM.png" />

Click a field on the ending page, followed by its `settings` <Icon icon="gear-complex" iconType="solid" />. Under **Logic**, set when to show or hide content based on answers.

### Show custom ending pages

Sometimes, multiple ending pages are easier to manage than one with too many hidden fields.

<img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/3ZcO_yEJK-WTjJHC/images/Screenshot2025-10-15at5.24.14PM.png?fit=max&auto=format&n=3ZcO_yEJK-WTjJHC&q=85&s=42496dd5ae33e3de506657bfcb037c8c" alt="Screenshot 2025-10-15 at 5.24.14 PM.png" width="2240" height="759" data-path="images/Screenshot2025-10-15at5.24.14PM.png" />

Click `+ Add page` at the bottom to add more ending pages. Then, open [page logic](/page-logic). Click the `connector icon` <Icon icon="circle-plus" iconType="solid" /> and drag the connector to the corresponding end page to set your conditions.

## Set up custom respondent emails

<Steps>
  <Step title="Choose a workflow template">
    Open form **settings**.

    Then, go to **Custom emails** to choose an [email workflow](/custom-emails). The quickest one is to create a **Thank you email**.

    <img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/3ZcO_yEJK-WTjJHC/images/Screenshot2025-10-15at4.55.39PM.png?fit=max&auto=format&n=3ZcO_yEJK-WTjJHC&q=85&s=7bfecd360dad8bab4d698f1876498f80" alt="Screenshot 2025-10-15 at 4.55.39 PM.png" title="Screenshot 2025-10-15 at 4.55.39 PM.png" style={{ width:"34%" }} width="730" height="137" data-path="images/Screenshot2025-10-15at4.55.39PM.png" />
  </Step>

  <Step title="Edit email contents">
    You can edit the default **Subject** and reference fields like score or name by clicking the `plus icon` <Icon icon="square-plus" iconType="solid" />.

    <img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/zC0LQIX9o5dnEI68/images/guides/image-43.png?fit=max&auto=format&n=zC0LQIX9o5dnEI68&q=85&s=d370824bbf24c41bb6fd8ac2709a4593" alt="PDF Viewer" style={{ width:"85%" }} width="1497" height="939" data-path="images/guides/image-43.png" />
  </Step>

  <Step title="Edit message (Optional)">
    Go to `Email` to edit the default message and reference fields. You can also [customize its style](https://www.fillout.com/help/custom-emails#style-your-email).

    <img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/KKmYfTaGUE6kYImk/images/Screenshot2025-10-15at6.44.32PM.png?fit=max&auto=format&n=KKmYfTaGUE6kYImk&q=85&s=86ff62a5b886ca6c241d90234c962f1a" alt="Screenshot 2025-10-15 at 6.44.32 PM.png" title="Screenshot 2025-10-15 at 6.44.32 PM.png" style={{ width:"87%" }} width="1825" height="1303" data-path="images/Screenshot2025-10-15at6.44.32PM.png" />
  </Step>

  <Step title="Add branches (Optional)">
    You can [personalize lead quiz notifications](/filter-branch-workflows#1530ee47667b80b5a331cff31ed5c22a) by sending custom emails depending on the score. First, add a `Branch` action to your workflow, then`Edit` to set up conditions.

    <img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/zC0LQIX9o5dnEI68/images/guides/image-45.png?fit=max&auto=format&n=zC0LQIX9o5dnEI68&q=85&s=9a517903ecae135e83e507e83a15ebf8" alt="PDF Viewer" width="2285" height="1228" data-path="images/guides/image-45.png" />

    <Tip>
      If you prefer to send formatted emails with custom styles, use Fillout’s [Sendgrid](/sendgrid) or [Mailchimp](/mailchimp) integrations.
    </Tip>
  </Step>
</Steps>

## Add calculations to ending pages and custom emails

Fillout’s [calculations](/calculations) features let you add, subtract, multiply, divide, or assign values from quiz answers (e.g. suggesting a daily caloric intake based on a respondent’s weight, height, and exercise frequency).

Open `Logic` and click `Calculations` to add dynamic values to an ending page or respondent email.

<img src="https://mintcdn.com/fillout-005a867b-dependabot-npm-and-yarn-socket-io-parser-4/zC0LQIX9o5dnEI68/images/guides/image-46.png?fit=max&auto=format&n=zC0LQIX9o5dnEI68&q=85&s=d8d68e5d82b0294ac8ea8f557e091848" alt="PDF Viewer" width="2244" height="1374" data-path="images/guides/image-46.png" />

## AI Quiz Maker

You can create a quiz in a few seconds using a prompt. Check our quick guide [here](https://www.fillout.com/help/ai-quizzes).

## Relevant articles

<CardGroup cols={3}>
  <Card title="Custom emails" color="#FFC738" icon="envelope-open-text" iconType="regular" href="/custom-emails">
    Automate sending, pipe previous answers, and style your email.
  </Card>

  <Card title="Calculations" color="#FFC738" icon="calculator-simple" iconType="regular" href="/calculations">
    Calculate prices for order forms, compute quiz scores, and more.
  </Card>

  <Card title="AI Quizzes" color="#FFC738" icon="lasso-sparkles" iconType="regular" href="/ai-quizzes">
    Create quizzes with the AI Quiz Maker and use ChatGPT.
  </Card>
</CardGroup>

<SupportBanner />
