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.

Rewards use the same studio layout as challenges, achievements, and posts: left-hand step sidebar, middle form, right-hand live preview.

​
Start a reward

Top nav -> + New -> Reward. You’ll land in the first wizard step with a blank reward in Draft. Every step autosaves.

​
Step-by-step

Basic Info

  • Title, description (rich text).
  • Image (with aspect-ratio crop).
  • Language + tags.
  • Metadata field (#940) — key-value map for arbitrary data you want exposed in integrations / webhooks.
  • Status starts as Draft.

Allocation

The “how many, and who can earn it” step.
  • Allocation type — Assets (owned items) or Entries (giveaway tickets).
  • Supply limit (#1451) — hard cap on how many can ever be issued.
  • Max per user and max per community — rate-limits.
  • Default values for new allocations (#661, #735, #639) — save time when cloning.
  • Reward pool labels (#2072) — visually group multi-allocation rewards.
Validation errors (#715, #1651) surface inline with actionable messages.

Redemption

How members actually claim the reward.
  • Code list upload — paste or CSV-upload redemption codes. Up to 500k codes per upload (#954).
  • Code upload fixes (#1275, #1853) — re-upload and edit without losing form state.
  • Redemption URL / instructions — shown in the member wallet.
  • autoRedeem — claim automatically on earn (see Advanced Features).

Advanced

Cross-community scope (#914, #916), draft-reward flag (#2011), scheduling, manual distribution, and more. See Advanced Features for the full list.

​
Manual distribution

Flip the Manual Distribution toggle (#2011) to make a reward admin-gifted only — members never earn it automatically. Pair with Reward Gifting to hand-pick recipients.

​
Draft rewards

Save any reward as Draft (#2011) while you finalise copy or wait for design assets. Draft rewards don’t distribute even if attached to a Live challenge — they queue up until you flip to Live.

​
The reward studio preview

The right-hand panel shows your reward as members see it: wallet row, asset card, redemption flow. Updates as you type.

​
Bulk code uploads

For discount codes, keys, or single-use tokens:
  1. Go to the Redemption step.
  2. Click Upload CSV (one code per row).
  3. Nudj validates, dedupes, and attaches the codes to the reward.
Uploads up to 500k codes complete server-side (#954). Re-uploads merge with the existing list; duplicates are dropped.
Keep a separate backup of your code list — Nudj holds the codes but doesn’t expose an export (for security). Use a password manager or secrets vault.

​
Validation gotchas

  • Rewards with zero supply save but can’t distribute. Pick a finite supply or Infinity.
  • Redemption config required for Asset rewards before flipping Live — either a code list, URL, or instructions.
  • Entry rewards don’t need redemption config — they resolve at the giveaway draw.

​
Next steps

Reward types

Full taxonomy of reward shapes.

Advanced features

autoRedeem, cross-community, RBAC gating.

Reward gifting

Admin gifts rewards to specific members.

Reward drops

Scheduled bulk CSV drops.