Skip to main content

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.

Giveaways (internally called “sweepstakes”) are Entry-based rewards with a fixed draw time. Members accumulate entries over the campaign; Nudj picks winners at drawsAt.
Terminology: The admin UI and member-facing app use “Giveaways”. Earlier docs used “Sweepstakes” interchangeably — we’re standardising on Giveaways.

​
Creating a giveaway

A giveaway is an Entry-type reward with a configured draw date.

Create an Entry reward

Start with + New -> Reward, pick Allocation type = Entries. Give it a name, description, and image.

Set drawsAt

Under Advanced -> Draws At, pick the draw time.
drawsAt validation (#638, #1561) enforces:
  • Date must be in the future.
  • Cannot draw before the reward goes Live.
  • Cannot draw during a scheduled window.

Attach to challenges

Add the Entry reward to one or more challenge Distribution steps. Each completion grants the configured number of entries.

Launch

Flip to Live. Members accumulate entries until drawsAt.

​
Processing the draw

At drawsAt, Nudj’s giveaway processor (#1265) picks winners based on the allocation’s mechanism:
  • Random — weighted by entry count.
  • All — everyone who entered wins.
  • Priority — first-N by entry count.
Admins can manually pick winners via the admin winner picker (#1342) for overrides or edge cases.

​
Viewing entrants

From the giveaway’s admin page:
  • Rich entrant list — sortable table with entry count, member details, opt-in status.
  • CSV export (#1133) — download the full entrant list for legal / compliance archiving.
The Reward Drop feature (#588, #2043) is separate from giveaways but often confused:
FeatureWhat it does
Giveaway / SweepstakesMembers earn entries, Nudj draws winners at drawsAt.
Reward DropAdmin uploads a CSV of recipients; every recipient gets the reward on a scheduled drop time.
Reward drops are for “I want to send a code to these specific 5,000 people next Friday”; giveaways are for “members earn tickets over 2 weeks, we pick 3 winners”.
Giveaways often trigger jurisdiction-specific rules. Nudj surfaces the tools — actual rule compliance is on you:
  • Use community rules with the agreement checkbox pattern (see Legal & Policies) to collect explicit opt-in.
  • Export the entrant CSV at drawsAt for audit retention.
  • Use manual winner picking (#1342) if you need to disqualify entries (e.g. bot activity).

​
Examples

Single Entry reward, drawsAt = next Sunday at 8pm. Attached to every Live challenge — any completion this week earns a ticket. Winner announced Monday.
Entry reward with 10,000+ allocation, drawsAt = day of the event. Members earn entries from specific launch-related challenges.