Preview-reel hero ordering
The preview reel is the vertical-swipe hero at the top of the mobile home screen: the first thing users see on open. It’s usually 3–7 series deep and rotates automatically.
How the order is decided
Section titled “How the order is decided”Each series has an editorial_hero_score (0–100). The preview reel is the top N series by score in the user’s market, filtered to status='published'.
- Higher score = closer to the top of the reel.
- Ties are broken by
created_at DESC(newer wins). - Series with
editorial_hero_score=0are excluded entirely.
Editing the reel
Section titled “Editing the reel”Curation → Preview reel shows the current reel in order with the score visible for each entry.
- Click Edit on a row to change its score.
- Or Add series to introduce a new candidate: set a starting score.
- Or Remove to zero the score (kicks the series out of the reel).
- Live preview shows the reel as the mobile app will render it.
What “hero” means
Section titled “What “hero” means”The hero image (16:9) uploaded during series creation is the visual. If a series doesn’t have a hero image, it can’t be in the reel: the preview page shows an inline warning and excludes it.
Rule of thumb
Section titled “Rule of thumb”- 3–5 series in the reel is the sweet spot. More than 7 and users start missing entries entirely.
- Rotate at least weekly. Stale hero = declining CTR.
- Keep at least one free-today series in the reel: pulls impulse browsers into a paid unlock loop.
API calls
Section titled “API calls”| Action | Endpoint |
|---|---|
| Read current reel | GET /v1/admin/preview-reel |
| Update reel (replace) | PUT /v1/admin/preview-reel |
Full details in API: Curation.