> ## 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.

# Rewards module

> Collect contact information from quiz winners for prize delivery

## What is the rewards module?

The rewards module automatically collects contact information from top quiz participants. After the session ends, winners receive a form to fill in their details - name, address, email, and phone - so you can send them prizes.

<Info>
  **Perfect for:** Contests, quiz lotteries, events with physical prizes, promotions.
</Info>

## How it works

<Steps>
  <Step title="Enable rewards module">
    In quiz settings, check **"Enable rewards module"** and choose the number of winners.
  </Step>

  <Step title="Define GDPR consent">
    Enter the data processing consent text.
  </Step>

  <Step title="Run the quiz">
    The quiz runs normally - participants compete for points.
  </Step>

  <Step title="Winners fill the form">
    After ending, TOP N participants see a form to submit their details.
  </Step>

  <Step title="Download rewards report">
    All data is available in a dedicated report (PDF/Excel).
  </Step>
</Steps>

## Configuration

### Enabling the module

In the quiz editor, find the **"Rewards"** section:

| Setting                   | Description                   |
| ------------------------- | ----------------------------- |
| **Enable rewards module** | Main toggle for the feature   |
| **Number of winners**     | From 1 to 10 people           |
| **GDPR consent text**     | Text accepted by participants |

<Warning>
  **Team mode:** The rewards module is not available in team mode. Rewards only work in individual mode.
</Warning>

### Default GDPR consent

Hey Quiz provides a default consent text that you can customize:

> I consent to the processing of my personal data (name, address, email, phone) by the quiz organizer for the purpose of prize delivery. The data will be processed solely for this purpose and will be deleted after prize shipment is completed. I have the right to access, correct, and delete my data.

<Tip>
  **Customize the text** for your specific contest - you can add information about the organizer, legal basis, or processing period.
</Tip>

## Form for winners

After the quiz ends, participants in TOP N places see a special form:

### Required fields

| Field                | Description                       |
| -------------------- | --------------------------------- |
| **Full name**        | Complete name for shipping        |
| **Shipping address** | Street, number, postal code, city |
| **Email address**    | For contact                       |
| **Phone number**     | For contact/courier               |
| **GDPR consent**     | Checkbox with consent text        |

### Time limit

<Warning>
  Participants have **24 hours** to fill out the form from when the quiz ends. After that, the form expires.
</Warning>

### Form statuses

| Status          | Meaning                            |
| --------------- | ---------------------------------- |
| **Pending**     | Participant hasn't filled it yet   |
| **Submitted**   | Data has been sent                 |
| **No response** | Deadline passed without submission |

## Rewards report

### Accessing the report

After the session ends, in the **Reports** section you'll find additional options:

<CardGroup cols={2}>
  <Card title="Rewards PDF report" icon="file-pdf">
    Formatted document with winner data for printing.
  </Card>

  <Card title="Rewards Excel report" icon="file-excel">
    Spreadsheet with data for further processing.
  </Card>
</CardGroup>

### Report contents

The rewards report includes:

* Quiz information (title, date, host)
* List of rewarded participants with:
  * Ranking position
  * Nickname and score
  * Full contact details
  * Submission status
  * Submission date

<Info>
  The rewards report is separate from the main session report and contains **only winner data** - not all participants.
</Info>

## Participant perspective

### What does a winner see?

1. **After quiz ends** - information about their ranking
2. **Rewards form** - with position, deadline, and fields to fill
3. **Confirmation** - after submitting the form
4. **Contact info** - that the organizer will contact them about the prize

### Who does NOT see the form?

* Participants outside TOP N (e.g., 4th place when 3 are rewarded)
* Participants who already filled the form
* Participants after the 24h deadline expires

## Use case examples

### Contest with physical prizes

* **Winners:** 3 people
* **Prizes:** 1st place - tablet, 2nd place - headphones, 3rd place - powerbank
* **Consent:** Standard + courier shipping information

### Quiz lottery

* **Winners:** 10 people
* **Prizes:** Online store vouchers
* **Consent:** Standard + lottery terms

### Corporate event

* **Winners:** 5 people
* **Prizes:** Company merchandise
* **Consent:** Extended with marketing consent (optional)

## FAQ

<AccordionGroup>
  <Accordion title="What if a winner doesn't fill the form?">
    After 24 hours, the status changes to "No response". There's no automatic mechanism to award the prize to the next person - that's the organizer's decision.
  </Accordion>

  <Accordion title="Can I change the number of winners after the quiz ends?">
    No. The number of winners is set before the session and cannot be changed after it ends.
  </Accordion>

  <Accordion title="Is the data secure?">
    Yes. Data is stored in compliance with GDPR, encrypted, and only accessible to the quiz host. Rewards data is automatically deleted when the quiz is deleted.
  </Accordion>

  <Accordion title="Does the module work in team mode?">
    No. The rewards module is only available in individual mode. It cannot be enabled in team mode.
  </Accordion>

  <Accordion title="Can a participant edit submitted data?">
    No. After submitting the form, data is locked. The participant should contact the organizer for corrections.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Quiz settings" icon="gear" href="/en/quizzes/settings">
    Full quiz configuration
  </Card>

  <Card title="Reports" icon="chart-pie" href="/en/reports/overview">
    Overview of all reports
  </Card>
</CardGroup>