> ## 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

> Image uploads, video actions, object detection, and aspect-ratio cropping

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](/admin-guide/achievements/reviewing-submissions) 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.

<Note>
  The legacy "image disclaimer" modal was removed (#740). If you need member consent, use the community rules / agreement checkbox pattern instead.
</Note>

### Video Action

Embed a video into the action and require a completion signal (watched to end, specific timestamp hit). See [Video Challenges](/admin-guide/challenges/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.

<Frame caption="Rich-media actions are added from the Action Library — Nudj's searchable catalog of action types, grouped by category.">
  <img src="https://mintcdn.com/nudj/IuOTwnkZBVty3Q7R/images/admin-guide/challenges/action-library.png?fit=max&auto=format&n=IuOTwnkZBVty3Q7R&q=85&s=0458f857b9c6e89235642e416418c04e" alt="The Action Library modal listing the action types you can add to a challenge" width="1920" height="1080" data-path="images/admin-guide/challenges/action-library.png" />
</Frame>

***

## Aspect ratio picker

When you create an image-upload action, pick a fixed ratio:

| Ratio          | Use case                                        |
| -------------- | ----------------------------------------------- |
| 1:1 square     | Profile-style submissions, social amplification |
| 10:4 banner    | Community banner submissions                    |
| 16:9 landscape | Video stills, widescreen content                |
| 4:5 portrait   | Instagram-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](/admin-guide/challenges/analytics) for full reporting context.

***

## Examples

<AccordionGroup>
  <Accordion title="UGC campaign" icon="camera">
    Single action: image upload (1:1 square, moderation-on). Members share pictures of their outfit of the day for a reward entry.
  </Accordion>

  <Accordion title="Tutorial verification" icon="graduation-cap">
    Video-watch action (full video completion) + a multi-choice question at the end.
  </Accordion>

  <Accordion title="Product-scan hunt" icon="magnifying-glass">
    Object-detection action scoped to "product barcode" — members scan the product in-store to verify purchase.
  </Accordion>
</AccordionGroup>