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

# Reward Drops

> Schedule bulk reward distribution via CSV to named recipient lists

A **Reward Drop** (#588) is a one-shot bulk distribution: you pick a reward, upload a recipient list via CSV (#2043), pick a drop time, and Nudj fans it out to every recipient at the scheduled moment.

## Drop vs. Giveaway vs. Gift

| Feature                                                                  | Use when                                                                        |
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| **[Reward Drop](/admin-guide/rewards/reward-drops)**                     | You have a specific list of recipients and want to deliver a reward on schedule |
| **[Giveaway / Sweepstakes](/admin-guide/rewards/sweepstakes-giveaways)** | Members earn entries over time, Nudj draws winners                              |
| **[Reward Gifting](/admin-guide/rewards/reward-gifting)**                | Small-scale manual hand-delivery to specific members                            |

***

## Creating a drop

<Steps>
  <Step title="Go to Rewards -> Drops" icon="truck">
    Or from any Asset reward, click **Schedule Drop** (Manager role+ required).
  </Step>

  <Step title="Pick a reward" icon="gift">
    Any Asset or Entry reward can be dropped. Supply limits apply — you can't drop 10k of a reward capped at 5k.
  </Step>

  <Step title="Upload recipient CSV" icon="file-csv">
    Upload a CSV with one `user_id` per row (#2043). Nudj validates the members exist and belong to the community.
  </Step>

  <Step title="Pick drop time" icon="calendar">
    Drop can be immediate or scheduled for the future.
  </Step>

  <Step title="Add optional points/XP" icon="coins">
    Bonus XP / points accompany the reward.
  </Step>

  <Step title="Save" icon="save">
    Scheduled drops appear in the drops list; at drop time, Nudj fans out allocations to every valid recipient.
  </Step>
</Steps>

***

## Post-drop reporting

After the drop runs, see:

* **Users processed** count.
* **Failed user IDs** list — typically due to invalid IDs, capped members, or deleted users.
* Distribution appears in the reward's analytics as "via drop".

***

## CSV format

Simple: one user ID per row, optional header.

```text theme={null}
user_id
507f1f77bcf86cd799439011
507f191e810c19729de860ea
...
```

For large drops (10k+ recipients), save as UTF-8 and upload. Processing is server-side and handles large files.

***

## Use cases

<AccordionGroup>
  <Accordion title="Anniversary drop" icon="cake-candles">
    Annual VIP appreciation — list of 500 top members, scheduled for community anniversary.
  </Accordion>

  <Accordion title="Compensation push" icon="triangle-exclamation">
    After a downtime incident, drop a "sorry" reward to affected members (exported from your incident log).
  </Accordion>

  <Accordion title="Campaign kickoff" icon="rocket">
    Drop early-access codes to a launch-week cohort hand-picked from analytics.
  </Accordion>
</AccordionGroup>

***

## RBAC

Manager and above can create drops. Admin+ can delete scheduled drops before they fire.

See [Roles & Permissions](/admin-guide/settings/rbac-and-roles).