---
name: upload-element-previews
description: Upload a Remotion Element's preview assets to remotion.media and replace local preview URLs. Use when given an Element slug, or when exactly one Element's preview assets are present in the current worktree.
---

# Upload Element Previews

1. Identify the Element slug. Ask if it is ambiguous.
2. Choose the source:
   - Use `render` for fresh files in `.element-previews`.
   - Use `submission` for committed files in `static/elements`.
3. Upload the previews:

```bash
cd packages/docs
bun run upload-element-preview \
  --element=<category>/<slug> \
  --source=<render|submission>
```

4. Replace `image`, `posterUrl`, and `videoUrl` with the printed `remotion.media` URLs.
5. If using `submission`, delete the local review assets. If using `render`, leave `.element-previews` uncommitted.
6. Commit and push when the work belongs on a branch.