> ## 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.
# Challenges
> Combine several quizzes into one running competition with a single leaderboard, deduplication across channels, and admin adjustments.
Challenges are currently in **beta**. To request access, please email [hello@doozy.live](mailto:hello@doozy.live).
A **challenge** ties several quizzes together into one running competition with a
single combined leaderboard. Instead of a separate board per quiz, points from
every quiz add up, so you can run something like "Security Awareness 2026" as a
month-long series and crown one overall winner.
For how an individual quiz is scored, see
[Scoring & Leaderboards](/quizzes/scoring).
## โก The short version
* A challenge is a set of quizzes that **share one leaderboard**.
* Each quiz is scored [out of 1000](/quizzes/scoring#why-your-score-is-out-of-1000),
and a player's challenge total is the **sum** of their per-quiz scores.
* Players are ranked by **total points**, so a late joiner is scored only on the
quizzes they received and can't leapfrog on a higher average.
* The same quiz posted to multiple channels is **answered once** and counts
everywhere.
## ๐ฅ For your team: how a challenge feels
### One leaderboard across many quizzes
A challenge is a set of quizzes that share a leaderboard. Each quiz is scored out
of 1000, and your challenge total is simply the sum of your per-quiz scores. Do
well across the series and you climb the combined board.
### Your "X / Y" and how ranking works
Your "X / Y" on a challenge shows how many of its quizzes have been **delivered to
you** so far. Ranking is by your **total points**, not by percentage. Join late
and you're scored only on the quizzes you actually received; you can't leapfrog
people who completed more just by having a higher average. Everyone competes on
points earned.
### You only answer each quiz once
The same quiz can be posted to several Slack channels, but it's still **one quiz**.
You'll only ever be asked to answer it once, and that single answer counts toward
the challenge no matter which channel you saw it in. If it shows up in two
channels, opening either takes you to the same attempt. You can't boost your score
by answering the same quiz in multiple places.
### Speed bonus is the same across the whole challenge
Whether the [speed bonus](/quizzes/scoring#the-speed-bonus) is on, and how long its
window is, is decided once for the entire challenge. Every quiz behaves the same
way, so the competition stays consistent.
## ๐ ๏ธ For admins: running a challenge
### What a challenge groups
A challenge groups **scheduled quizzes**. Any quiz linked to the challenge
becomes a member and its scores feed the combined board.
**A quiz embedded in a track can't join a challenge.** It runs as part of its
track. Challenges group standalone scheduled quizzes.
Membership comes from the quizzes themselves, so adding or removing a quiz is just
linking or unlinking it. There's no separate list to keep in sync.
### Setting one up
Give it a clear name (e.g. "Security Awareness 2026") and an optional
description. It's live as soon as you create it.
Leaderboard, Own rank, or Hidden. See the
[visibility table](/quizzes/scoring#leaderboard-visibility).
On or off, and if on, the bonus window. This applies **uniformly** to every
quiz in the challenge and **overrides** each quiz's own speed setting, so the
board stays coherent.
Link your scheduled quizzes to the challenge. Each one is then scored
out of 1000 and its scores roll into the total.
Only the challenge's admin users can manage it and view aggregate results.
Question weighting stays on each quiz (Standard, Double, or Triple per question),
while the speed bonus and visibility are set once on the challenge.
### How the combined leaderboard is calculated
1. Each member quiz is scored and **rescaled to /1000** for every player.
2. A player's challenge total is the **sum** of their per-quiz scores.
3. Players are ranked by that total (absolute points, not percentage).
4. Any manual adjustments are layered on top at the end (see the
**Adjustments** section below).
Because the challenge speed setting is uniform across every quiz, the per-quiz
scores all rescale to /1000 and add up cleanly.
## ๐ Deduplication (play once)
When the same quiz is scheduled to multiple channels, Doozy treats every
copy as **one logical quiz** so nobody answers it (or gets reminded about it)
twice:
* **To-dos collapse.** Someone in three channels that all received the quiz sees
**one** to-do, not three.
* **Opening any copy lands on the same attempt.** A person answers the **first**
copy they received. If that copy expires before they touch it, Doozy rolls them
forward to the earliest copy still answerable. Once they've started a copy, they
stay on it.
* **One shared score.** That single answer feeds one shared per-quiz leaderboard,
so it counts everywhere the quiz was posted.
Only repeated runs of the **same** quiz collapse this way. Different quizzes are
always kept separate.
## โธ๏ธ Lifecycle: pause, complete, archive
A challenge is **active** when created. Every other state is a **cutoff**: member
quizzes stop delivering, new answers are rejected, and the leaderboard **freezes**
so you can lock in final standings. The states differ in intent and presentation.
| State | Meaning | Board |
| ------------- | ----------------------------------------- | ------------------------------------------------ |
| **Active** | Running. | Live, updating. |
| **Paused** | Temporarily stopped, meant to resume. | Frozen ("โธ๏ธ Paused, results frozen"). |
| **Completed** | Finished with final results, still shown. | Frozen ("๐ Challenge complete, final results"). |
| **Archived** | Filed away and hidden from the main list. | Frozen; can be deleted from here. |
Allowed transitions:
| From โ | Active | Paused | Completed | Archived | Deleted |
| ------------- | ------ | ------ | --------- | -------- | ------- |
| **Active** | n/a | pause | complete | archive | โ |
| **Paused** | resume | n/a | complete | archive | โ |
| **Completed** | reopen | โ | n/a | archive | โ |
| **Archived** | โ | โ | unarchive | n/a | delete |
* **Pausing or archiving also pauses the member quizzes** Doozy is running, so no
new questions post after the cutoff. Resuming re-activates only the quizzes the
challenge paused, never one you'd paused yourself.
* **Deleting keeps the data.** Delete (only from Archived) removes the challenge
and its cached board and unlinks the quizzes. The quizzes and all participation
data survive.
## โ๏ธ Adjustments
You can hand-edit a challenge leaderboard. Adjustments layer on top of the
calculated scores at display time, so they show up right away and never disturb the
underlying per-quiz results.
**Per-person, from the row's โฎ menu:**
* **Adjust points**: add or subtract points for that person, with an optional
reason. Added on top of their score and uncapped; use a negative number to
subtract. Their total shows a small badge so an adjusted score reads differently
from an earned one.
* **Remove from board**: drop someone's row. Reversible; their data is kept, just
hidden.
**Board-level Manual adjustment:**
* Award points to **any member, including someone who never played** (a referral
reward, say). They appear on the board as a new row with the awarded points. Use
a negative number to subtract.
**The Adjustments panel** lists every change in one place: each point award with
who made it, when, and why, plus an **Undo** for each (an undone entry stays
visible, struck through, so the history is legible). Removed people are listed
separately with a **Restore** button.
Adjusted points are added **on top** and are **uncapped**, so a total can exceed
1000 per quiz's worth. That's intentional, since a referral or bonus award isn't a quiz
score. The badge on the total flags it.
## ๐ข Worked example
A 3-quiz challenge, **speed bonus off**, visibility set to **Leaderboard**.
Riya joined after Quiz 1 had already gone out, so only Quizzes 2 and 3 were
delivered to her. Marcus received all three.
| Player | Quiz 1 | Quiz 2 | Quiz 3 | Delivered | Total |
| ------ | ------ | ------ | ------ | --------- | -------- |
| Marcus | 1000 | 800 | 900 | 3 / 3 | **2700** |
| Riya | n/a | 1000 | 1000 | 2 / 3 | **2000** |
Riya aced both quizzes she received, but she's ranked on her **2000 total**, not on
a 100% average, so she sits behind Marcus's 2700. A late joiner can't leapfrog on
percentage.
Now an admin awards Riya **+200** as a referral reward:
```
Riya: 2000 +200 (referral) = 2200 [+200]
```
Her total updates immediately with a "+200" badge, and the award appears in the
Adjustments panel with an Undo.
## ๐ What challenge standings look like
```
๐ Security Awareness 2026 standings
1. Marcus Bell 2700 ยท 3 / 3
2. Riya Kapoor 2200 [+200] ยท 2 / 3
3. Dana Okafor 1850 ยท 3 / 3
4. Sam Rivera 1600 ยท 2 / 3
โธ๏ธ Paused, results frozen (shown only when not active)
```
## โ FAQ
No. A quiz embedded in a track runs as part of that track. Challenges group
standalone scheduled quizzes.
No. It's one logical quiz; each person answers once and that single result
counts across every channel it appeared in.
No. Pausing stops the member quizzes and freezes the board. Any question window
already open is also blocked from new submissions. Resume to pick back up.
No. Delete removes the challenge and its leaderboard and unlinks the quizzes.
The quizzes and all answers are kept.
A manual adjustment (like a referral reward) is added on top of the calculated
score and isn't capped. The badge on their total flags it.
Adjustments apply at display time and boards refresh within a few seconds.
Re-open the standings and it'll be there.
## ๐ Related
How each quiz is scored, before challenges combine them
Create the quizzes that go into a challenge
View participation, scores, and feedback
Everything quizzes can do