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

# Video Challenges

> Timestamp-based video actions, YouTube integration, completion UI, admin video builder

Video challenges are a first-class pattern in Nudj: members watch a video and answer questions at specific timestamps, or simply complete-to-watch.

## The purpose-built admin UI

Nudj has a dedicated admin UI for video challenges (#1138) — not a generic challenge editor with a video attached. This means:

* Timestamp picker synced with video playback.
* Per-timestamp action creation (question, completion marker, poll).
* Video preview inline with the admin editor.

***

## Creation flow

<Steps>
  <Step title="Start a video challenge" icon="film">
    * New -> Challenge. Pick the **Video** template (or add a video action to a standard challenge).
  </Step>

  <Step title="Attach the video" icon="link">
    Enter a YouTube URL. The agent can draft a YouTube action for you (#1085) — it resolves the channel, video metadata, thumbnail.
  </Step>

  <Step title="Configure completion" icon="square-check">
    The video config (#1114) sets what counts as "completed":

    * Full watch
    * X% watched (e.g. 90%)
    * Specific timestamp hit
  </Step>

  <Step title="Add timestamp actions" icon="clock">
    Pause at any point in the video and add an action: question, poll, checkpoint. Members see the action mid-video (#944, #949).
  </Step>

  <Step title="Set rewards" icon="gift">
    Distribution works like any other challenge — points, XP, assets, entries.
  </Step>

  <Step title="Preview + publish" icon="rocket">
    The [3-column preview](/admin-guide/challenges/preview-mode) shows the video player experience. Save, flip Live. (Save bug #1286 fixed.)
  </Step>
</Steps>

***

## Action components

The video wizard uses dedicated action components (#1076) so the editor works smoothly — each timestamp action has its own UI tuned for video context.

***

## Completion UI

The member-facing completion UI (#1089) shows progress against the video:

* Progress bar synced with playback
* Timestamp pins marked as you pass them
* Instant action popups at configured timestamps
* Completion celebration at the end

***

## YouTube MCP integration

When the Nudj Agent drafts a video challenge, it can use YouTube MCP tools (see [Nudj Agent](/admin-guide/ai-agent)) to fetch metadata, thumbnails, and video lists automatically.

***

## Examples

<AccordionGroup>
  <Accordion title="Product tutorial with checkpoints" icon="graduation-cap">
    10-minute tutorial with a quiz question every 2 minutes. Members who get 80% correct earn a completion reward.
  </Accordion>

  <Accordion title="Livestream recap" icon="tower-broadcast">
    Recording of a livestream — members watch back within 7 days for bonus points. No mid-video actions, just a completion checkpoint at the end.
  </Accordion>

  <Accordion title="Brand-launch video" icon="rocket">
    2-minute launch reel with a single action at the end: "share this on Twitter". Paired with a subscribe-to-channel action for amplification.
  </Accordion>
</AccordionGroup>