Nudj has a flexible reward model. Every reward is one of these shapes — pick the type based on whether members “own” something (Asset), enter a lottery (Entry), earn currency (Points/XP), or collect an emblem (Badge).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.
Core types
Asset
An owned item (discount code, digital download, physical shipment token). Each Asset has a finite supply and a redemption config (code, URL, instruction, etc).
Entry
A giveaway ticket — members accumulate entries, you pick winners at draw time. See Sweepstakes & Giveaways.
Points
Spendable currency. Members use points at the shop or to unlock key-gated challenges.
XP
Progression currency. Feeds Levels and Loyalty Tiers.
Specialty types
Badge
A collectible emblem — no redemption required, just “held”. Members see badges on their profile. Badge-reward crashes from older codepaths were fixed in #2249. See Badges.Reward Drop (#588)
Scheduled bulk distribution: pick a reward, pick a recipient list (CSV upload via #2043), pick a drop time. Perfect for anniversary rewards, compensation pushes, or VIP surprise drops. See Reward Drops.Spotlight Reward
A reward pinned to the community feed for a fixed window — used for flash promotions. Configured on the reward itself; sticks to the top of the wallet/shop until its window closes.Scheduled Rewards (#1223)
Attach a reward to a challenge with a future date. Nudj won’t expose the reward until the scheduled time — useful for staged launches where the challenge goes live but the reward unlocks later.Loyalty-tier Entry Rewards (#2243)
Each loyalty tier can have its own default entry reward allocation. A Gold-tier member automatically gets larger entries on the same challenge than a Bronze member.Redemption options
All assets support:- autoRedeem (#819, #957) — reward auto-claims on earn, no member action required. Great for XP/points boosters or instant discount codes.
- Manual redemption — member claims explicitly, surfaces in the wallet.
- Redemption codes — bulk-uploadable code lists (see Creating Rewards).
Cross-community distribution
Rewards can be scoped to multiple communities via the additionalCommunityIds field (#914, #916) — useful for orgs running several communities with shared catalogues. A single “VIP Discount” reward can be redeemable across all communities without duplicating data.When to use which
| Goal | Pick |
|---|---|
| Hand out discount codes | Asset with redemption code list |
| Run a sweepstakes | Entry + drawsAt schedule |
| Reward community participation over time | Points (spendable) + XP (progression) |
| Celebrate milestones visibly | Badge |
| Surprise drop to a subset of members | Reward Drop |
| Flash promotion | Spotlight Reward |
| Tiered VIP treatment | Loyalty Tier entry rewards |
Next steps
Create regular rewards
Assets, entries, points, XP.
Advanced features
autoRedeem, cross-community, draft rewards, scheduled.
Sweepstakes / giveaways
Entry-based prize draws.
Shop integration
Point-spending catalog.