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

# Quiz Scoring & Leaderboards

> How quiz scores are calculated: points per question, the speed bonus, the out-of-1000 score, Trivia, and leaderboards.

Understand exactly how Doozy scores a quiz: how points are earned, how the
**speed bonus** works, why every quiz is scored **out of 1000**, and how Trivia
is different. To see how scores combine across a series of quizzes, see
[Challenges](/quizzes/challenges).

## ⚡ The short version

A quiz score has two parts:

1. **Correctness**: getting questions right. Each question counts by its **weight**
   (Standard, Double, or Triple), set on the quiz.
2. **Speed bonus**: optional extra for answering quickly. Set when you schedule the
   quiz (or on a challenge), and **off by default**.

```
each question you get right  →  counts for its weight (+ speed bonus, if on)
each question you get wrong  →  counts for nothing
```

To keep every quiz comparable, your total is rescaled to a **score out of 1000**.
A flawless run is 1000. Trivia is the one exception and keeps its classic
"points + position" style.

<Note>
  This page describes how scoring works for your team and how to set it up. People
  always see their own correct and incorrect results; the leaderboard settings only
  control who sees ranks and the board.
</Note>

## 👥 For your team: what a score means

### Getting answers right

Get a question right and it counts toward your score; get it wrong and it counts
for nothing. There's no penalty for a wrong answer beyond missing out on that
question. Most quizzes count every question equally, though a question can be
**weighted** to count more (see the admin section below).

### The speed bonus

If the speed bonus is turned on, answering quickly earns extra points on top of a
correct answer. The bonus is biggest the instant a question posts and shrinks
steadily until it reaches zero at the end of the **bonus window**. After that, a
correct answer is still worth full correctness points, just no bonus.

The speed bonus can add up to **half again** on top of a correct answer, so a
perfect, instant answer counts for 1.5× a correct-but-slow one. You're racing the
clock, not other people, so you can earn the full bonus even if you're the only one
playing.

If the speed bonus is **off**, only correctness counts and timing makes no
difference.

### Your "X / Y"

Next to your score you'll see something like **4 / 5**. That's how many you got
right out of how many were **delivered to you**. A delivered question you didn't
answer counts as a miss, so skipping one shows as "3 / 5", not "3 / 3".

### Why your score is out of 1000

A quiz might have 5 questions or 50, and some may count more than others. To keep
every quiz on the same footing (and to let scores add up across a
[challenge](/quizzes/challenges)), Doozy rescales your total to a **score out of
1000**. A perfect run is exactly 1000, and people who tie at the top each get 1000
(ties are never split).

So getting 4 of 5 equally weighted questions right, with no speed bonus, shows as
**800 / 1000**.

### Late answers

If a quiz has a due date and the organizer turned on **partial credit**, answers
submitted after the due date (but before the quiz closes) earn a reduced share of
their normal credit and **no speed bonus**. Answer on time to earn full points.

## 🛠️ For admins: setting up scoring

Scoring uses the **same controls** in two places:

* **On a single quiz's schedule**: the scoring options when you
  [schedule a quiz](/quizzes/schedule-a-custom-quiz).
* **On a challenge**: set once and applied uniformly to every quiz in it
  (see [Challenges](/quizzes/challenges)).

### Question weighting

You can't put a custom point value on a question. Instead, each question has a
**weight** that decides how much it counts toward the score:

| Weight                 | Counts as   |
| ---------------------- | ----------- |
| **Standard** (default) | Once        |
| **Double**             | Twice       |
| **Triple**             | Three times |

New questions start at Standard. Set a question to Double or Triple to give it a
bigger share of the quiz's 1000 points. With every question at Standard, they all
count equally.

### Speed bonus: on or off

| Setting                      | What players experience                                                      |
| ---------------------------- | ---------------------------------------------------------------------------- |
| **No speed bonus** (default) | Only correctness counts; timing is irrelevant.                               |
| **Speed bonus**              | Faster correct answers earn extra, decaying to zero across the bonus window. |

When the speed bonus is on, you also set the **bonus window**: how long after a
question posts the bonus takes to decay to zero. It defaults to **1 hour** and can
be set in minutes, hours, or days. Shorter windows reward only the very quickest
answers.

<Note>
  The speed bonus tops out at **+50%**: answering the instant a question posts counts
  for 1.5× its normal credit, decaying to no bonus by the end of the window. This
  headroom is built into the out-of-1000 rescaling, so a flawless, instant run lands
  at exactly 1000 and never more.
</Note>

### Late submissions

If a quiz has a due date, you choose what a late-but-still-open answer is worth:

| Setting                   | Effect                                                                                             |
| ------------------------- | -------------------------------------------------------------------------------------------------- |
| **Full points** (default) | Late answers score the same as on-time ones, until the quiz closes.                                |
| **Partial credit**        | Late correct answers earn a set share of their normal credit (default **50%**) and no speed bonus. |

<Warning>
  Partial credit only takes effect if the quiz has a due date. Answers after the
  quiz fully closes are rejected and never scored.
</Warning>

### Leaderboard visibility

The leaderboard control sets who sees what. People always see their own results
either way, and admins always see the full board.

| Option          | What people see                                             |
| --------------- | ----------------------------------------------------------- |
| **Leaderboard** | Everyone sees the full ranked board with names and scores.  |
| **Own rank**    | Each person sees only their own standing (e.g. "#3 of 24"). |
| **Hidden**      | No rank and no board, just each person's own score.         |

## 🧠 Trivia is different

Trivia (the recurring weekly or monthly quiz) keeps its classic arcade scoring and
is **not** rescaled to 1000:

* Each correct answer is worth a flat **100 points**.
* The first to answer correctly gets a **+20** position bonus, the second **+19**,
  down to **+1** for the 20th, then nothing.
* Boards show raw **"X pts"** plus your rank.

Because that position bonus is about beating the room rather than the clock, Trivia
scores aren't normalized and Trivia can't be part of a [challenge](/quizzes/challenges).
See [Trivia and Icebreakers](/trivia-and-icebreakers/overview) for more.

## 🔢 Worked examples

<AccordionGroup>
  <Accordion title="No speed bonus: 4 of 5 correct">
    A 5-question quiz where every question is **Standard** weight, so each is an
    equal share of the 1000. Dana gets 4 right.

    ```
    earned = 4 of the 5 equal shares
    score  = 4 / 5 × 1000 = 800     →  "800 / 1000",  "4 / 5"
    ```
  </Accordion>

  <Accordion title="Weighting: one Double question">
    A 5-question quiz with four **Standard** questions and one **Double**. The
    Double counts twice, so the quiz is scored over 6 shares (4 × 1 + 1 × 2).

    ```
    miss one Standard question   → earned 5 of 6 shares → 833 / 1000
    miss the Double question     → earned 4 of 6 shares → 667 / 1000
    ```

    Same number wrong, different score: the Double question carries more weight.
  </Accordion>

  <Accordion title="Speed bonus on: answered halfway through the window">
    A one-question quiz with the speed bonus on (1-hour window). The most you can
    score is 1000, by answering correctly the instant the question posts.

    ```
    correct, instant              →  1000 / 1000   (full speed bonus)
    correct, halfway through      →   833 / 1000   (half the speed bonus)
    correct, at the window's end  →   667 / 1000   (bonus gone)
    wrong                         →     0 / 1000
    ```

    A correct answer always beats a wrong one, and among correct answers the
    quicker one ranks higher. Only a perfect, instant run reaches 1000.
  </Accordion>

  <Accordion title="Trivia: first and second to answer">
    A trivia question worth the flat 100. Priya answers correctly first, Alex
    second.

    ```
    Priya = 100 + 20 (first)  = 120 pts
    Alex  = 100 + 19 (second) = 119 pts
    ```

    Shown raw as "120 pts" and "119 pts" with each player's rank. No /1000 here.
  </Accordion>
</AccordionGroup>

## 🏆 What a board looks like

A normal (rescaled) quiz board:

```
🏆  Weekly Knowledge Check

  1.  Dana Okafor        1000 / 1000   ·  5 / 5
  2.  Sam Rivera          833 / 1000   ·  4 / 5
  3.  Jordan Lee          800 / 1000   ·  4 / 5
  4.  Priya Shah          600 / 1000   ·  3 / 5
```

A Trivia board (raw points + position):

```
🧠  Trivia this week

  1.  Priya Shah         420 pts
  2.  Alex Morgan        399 pts
  3.  Dana Okafor        300 pts
```

## ❓ FAQ

<AccordionGroup>
  <Accordion title="Why is my quiz scored out of 1000 when it only had 5 questions?">
    So every quiz is comparable and scores add up cleanly across a challenge. Your
    raw points are rescaled; a perfect run is always 1000.
  </Accordion>

  <Accordion title="I answered everything correctly but didn't get 1000. Why?">
    On a quiz with the speed bonus on, the maximum (1000) assumes you answered every
    question correctly **and** instantly. Correct-but-slower answers land below 1000.
  </Accordion>

  <Accordion title="Does a wrong answer cost me points?">
    No. A wrong answer just earns nothing for that question. There's no negative
    scoring.
  </Accordion>

  <Accordion title="Two of us tied for first with perfect runs. Is the score split?">
    The score is never split. With no speed bonus, everyone who gets every question
    right ties at the full 1000. With the **speed bonus on**, getting everything
    right isn't enough to reach 1000 on its own; you also need to be quick. So the
    speed bonus is what separates otherwise-tied players, and only a perfect,
    instant run hits 1000.
  </Accordion>

  <Accordion title="My score didn't update right away.">
    Leaderboards refresh within a few seconds. Re-open the board and it'll catch up.
  </Accordion>
</AccordionGroup>

## 🔗 Related

<CardGroup cols={2}>
  <Card title="Challenges" icon="trophy" href="/quizzes/challenges">
    Combine quizzes into one running leaderboard
  </Card>

  <Card title="Schedule a quiz" icon="clock" href="/quizzes/schedule-a-custom-quiz">
    Set scoring and delivery when you send a quiz
  </Card>

  <Card title="Quiz results" icon="chart-bar" href="/quizzes/quiz-results">
    View participation, scores, and feedback
  </Card>

  <Card title="Trivia" icon="brain" href="/trivia-and-icebreakers/overview">
    The recurring trivia game and its scoring
  </Card>
</CardGroup>
