> ## Documentation Index
> Fetch the complete documentation index at: https://fillout.com/help/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. 

## 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/yK9I9fmmmdkYCBW-/images/Screenshot2025-10-15at4.55.39PM.png?fit=max&auto=format&n=yK9I9fmmmdkYCBW-&q=85&s=5e78270d5e5b5d693db1f4ff87f5d9c2" 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/yK9I9fmmmdkYCBW-/images/Screenshot2025-10-15at4.55.53PM.png?fit=max&auto=format&n=yK9I9fmmmdkYCBW-&q=85&s=500e6cdc1e3b21fadec417d4e0f410cc" 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/yK9I9fmmmdkYCBW-/images/Screenshot2025-10-15at5.32.47PM.png?fit=max&auto=format&n=yK9I9fmmmdkYCBW-&q=85&s=2222d3467624d01a7e52d1619b145ec7" 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/yK9I9fmmmdkYCBW-/images/Screenshot2025-10-15at5.38.31PM.png?fit=max&auto=format&n=yK9I9fmmmdkYCBW-&q=85&s=0cb0e6b7dec47767e42ea414636116ef" 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/yK9I9fmmmdkYCBW-/images/Screenshot2025-10-15at5.01.31PM.png?fit=max&auto=format&n=yK9I9fmmmdkYCBW-&q=85&s=85ab868a7a6304c5b0f77ff2e2abf5f4" 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/yK9I9fmmmdkYCBW-/images/Screenshot2025-10-15at5.40.16PM.png?fit=max&auto=format&n=yK9I9fmmmdkYCBW-&q=85&s=54f6837b7f35952b341f29745681d81c" 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/yK9I9fmmmdkYCBW-/images/Screenshot2025-10-15at5.21.46PM.png?fit=max&auto=format&n=yK9I9fmmmdkYCBW-&q=85&s=33e3a3148d2797c1cfa1b705a431d152" 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/yK9I9fmmmdkYCBW-/images/Screenshot2025-10-15at5.24.14PM.png?fit=max&auto=format&n=yK9I9fmmmdkYCBW-&q=85&s=5f9ed1717835de5acaa68bd915a207c4" 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/yK9I9fmmmdkYCBW-/images/Screenshot2025-10-15at4.55.39PM.png?fit=max&auto=format&n=yK9I9fmmmdkYCBW-&q=85&s=5e78270d5e5b5d693db1f4ff87f5d9c2" 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/GDuTdz0rJBKQOqLV/images/guides/image-43.png?fit=max&auto=format&n=GDuTdz0rJBKQOqLV&q=85&s=d509e6ffbde2ba95c072ca868d9e62f9" 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/A3GkqSne2tA6VOCA/images/Screenshot2025-10-15at6.44.32PM.png?fit=max&auto=format&n=A3GkqSne2tA6VOCA&q=85&s=244759003fdfd3d935628bafd19a71a7" 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/GDuTdz0rJBKQOqLV/images/guides/image-45.png?fit=max&auto=format&n=GDuTdz0rJBKQOqLV&q=85&s=5d2ad46340e7aa735409b82be6a796f0" 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/GDuTdz0rJBKQOqLV/images/guides/image-46.png?fit=max&auto=format&n=GDuTdz0rJBKQOqLV&q=85&s=bcdcacd535c83f6620e0986eb643244d" 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>
