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.

Rich-media actions accept file uploads (images, video) or embed video players. They’re used for user-generated content (UGC) challenges, moderation-gated submissions, and video-driven experiences.

Action types

Image Upload

Members upload a photo to complete the action. Admin reviews in the Review Achievement Flow queue.
  • Compression to WebP happens on upload (#778) — storage + bandwidth optimisation, transparent to admins.
  • Strict aspect ratio enforcement (#828): choose a fixed ratio so all submissions fit the member gallery layout. Cropping is rounded (#811) so images look intentional, not cut.
  • Banner upload above the action (#647) for context.
  • Image upload reporting (#1504) tracks success/failure rates per action.
  • Re-upload after failure works cleanly (#1853) — members can retry without losing their form state.
The legacy “image disclaimer” modal was removed (#740). If you need member consent, use the community rules / agreement checkbox pattern instead.

Video Action

Embed a video into the action and require a completion signal (watched to end, specific timestamp hit). See Video Challenges for the purpose-built admin UI (#1138, #944, #1076, #1114).

Object Detection

Members upload a photo and the action passes only if the AI detects a specific object class (e.g. “dog”, “product barcode”). Backwards compatibility for existing object-detection configs was added in #846 — your old detection rules keep working after the refactor.

Aspect ratio picker

When you create an image-upload action, pick a fixed ratio:
RatioUse case
1:1 squareProfile-style submissions, social amplification
10:4 bannerCommunity banner submissions
16:9 landscapeVideo stills, widescreen content
4:5 portraitInstagram-style mobile feed
Strict ratio enforcement means members see a crop UI before submission, not after — no surprise distortion in the gallery.

Image reporting

The admin view for each rich-media action shows:
  • Submissions count (success vs. failed upload)
  • Review queue size (if moderation is on)
  • CSV export of raw submissions
  • Per-member thumbnail gallery
See Challenge Analytics for full reporting context.

Examples

Single action: image upload (1:1 square, moderation-on). Members share pictures of their outfit of the day for a reward entry.
Video-watch action (full video completion) + a multi-choice question at the end.
Object-detection action scoped to “product barcode” — members scan the product in-store to verify purchase.