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

# Hosting the quiz

> Controlling the quiz session in real-time

## Overview

After clicking **Start** in the lobby, the actual quiz session begins. As the host, you have full control over the pace and flow of the quiz.

## Host view

### Screen elements

| Element              | Description                 |
| -------------------- | --------------------------- |
| **Question**         | Current question text       |
| **Answers**          | List of possible answers    |
| **Timer**            | Countdown timer             |
| **Response counter** | How many have answered      |
| **Progress bar**     | Which question out of total |
| **Control panel**    | Action buttons              |

### Control panel

Available actions:

<CardGroup cols={2}>
  <Card title="Show answer" icon="eye">
    Reveals the correct answer to all participants.
  </Card>

  <Card title="Next question" icon="arrow-right">
    Moves to the next question.
  </Card>

  <Card title="Pause timer" icon="pause">
    Stops the countdown (optional).
  </Card>

  <Card title="Show ranking" icon="trophy">
    Displays current leaderboard.
  </Card>
</CardGroup>

## Question flow

<Steps>
  <Step title="Question displays">
    Participants see the question and answers. Timer starts counting down.
  </Step>

  <Step title="Participants answer">
    Everyone chooses their answer. You see the response counter.
  </Step>

  <Step title="Time runs out">
    Timer reaches zero or everyone has answered.
  </Step>

  <Step title="Show the answer">
    Click **"Show answer"** - participants see if they got it right.
  </Step>

  <Step title="Move forward">
    Click **"Next question"** or **"Show ranking"**.
  </Step>
</Steps>

## Question statistics

After each question ends, you see:

| Statistic               | Meaning                    |
| ----------------------- | -------------------------- |
| **Answer distribution** | How many chose each option |
| **Correct percentage**  | What % answered correctly  |
| **Average time**        | How fast they answered     |
| **Fastest answer**      | Who answered first         |

## Leaderboard

### When to show the leaderboard?

You have flexibility - you can show the ranking:

* After every question
* Every few questions
* Only at the end

<Tip>
  **Recommendation:** Show the leaderboard every 3-5 questions to maintain engagement without breaking the rhythm.
</Tip>

### Leaderboard elements

* **Position** - rank in the standings
* **Avatar and nickname** - participant identification
* **Points** - current point total
* **Position change** - up/down arrows

## Team mode

If you enabled team mode:

### Team ranking

* Individual points sum to team score
* You see a separate team ranking
* You can switch between individual and team views

### Team statistics

* Team average points
* Best player on the team
* Team's correct answer percentage

## Survival mode

If you enabled Survival mode:

### Lives indicator

* Each participant has visible lives count
* Wrong answer = lose a life
* Eliminated players are marked

<Warning>
  Eliminated participants are **not disconnected** - they still see questions but don't earn points.
</Warning>

## Raise Hand questions

Special flow for Raise Hand questions:

<Steps>
  <Step title="Question displays">
    Participants see a **"Raise Hand"** button.
  </Step>

  <Step title="Someone raises hand">
    First participant is highlighted. Timer stops.
  </Step>

  <Step title="Verbal answer">
    Participant answers verbally.
  </Step>

  <Step title="Host evaluation">
    You click **"Correct"** or **"Wrong"**.
  </Step>

  <Step title="Continue">
    If wrong - next person can try.
  </Step>
</Steps>

## Problems during session

<AccordionGroup>
  <Accordion title="Participant disconnected">
    * Will automatically return after refresh
    * Their answers are preserved
    * Can continue the quiz
  </Accordion>

  <Accordion title="Timer counting too fast/slow">
    * Timer is synchronized with server
    * Check internet connection
    * Refresh page if problems persist
  </Accordion>

  <Accordion title="Answers not registering">
    * Check participant's connection
    * Ask them to refresh the page
    * In extreme cases - restart session
  </Accordion>
</AccordionGroup>

## Pausing the session

<Info>
  There's no formal pause function, but you can:

  * Wait before clicking "Next question"
  * Stop the timer (if available)
  * Display ranking and discuss results
</Info>

## Keyboard shortcuts

| Action        | Shortcut       |
| ------------- | -------------- |
| Next question | `Space` or `→` |
| Show answer   | `Enter`        |
| Show ranking  | `R`            |

## Tips for hosts

<Check>
  **Maintain contact with participants** - comment on questions, praise fast answers.
</Check>

<Check>
  **Control the pace** - don't rush between questions.
</Check>

<Check>
  **React to technical issues** - pause if someone has problems.
</Check>

<Check>
  **Build tension** - pause briefly before revealing the answer.
</Check>

## Next steps

<CardGroup cols={2}>
  <Card title="Remote Pilot" icon="mobile" href="/en/sessions/remote-pilot">
    Control from your phone
  </Card>

  <Card title="Ending the session" icon="flag-checkered" href="/en/sessions/ending">
    Summary and results
  </Card>
</CardGroup>