What’s in it
- Every image uploaded to the admin panel
- Organised by tag and upload date
- Searchable by filename
- Supports common image formats (including WebP)
- Recommended aspect ratios surfaced via the crop tool where applicable (#828)
Uploading
Upload from any image picker in the admin — challenges, rewards, posts, theme. New uploads land in the Asset Library automatically.Standard aspect ratios
| Ratio | Default use |
|---|---|
| 1:1 square | Challenge / reward / achievement icons |
| 10:4 banner | Community banner (#777) |
| 16:9 landscape | Post hero, video thumbnail |
| 4:5 portrait | Mobile-first feed content |
Image format handling
Uploads are validated for supported file types and size limits, then stored as-is. Upload WebP yourself when you want the bandwidth savings — 30-50% smaller than PNG/JPG at equivalent quality. Automatic format conversion is not currently part of the upload pipeline.Upload reporting
Image upload success / failure is tracked (#1504) — useful for diagnosing mysterious “my image doesn’t show” bugs. Upload icon overflow (#2296) was also fixed so the drag-drop target stays clickable.Background images
Backgrounds for challenges, rewards, games, and themes all go through the same uploader (#996) — consistent crop tool, consistent compression.Reuse patterns
Per-series banners
Per-series banners
Theme asset set
Theme asset set
Upload your brand’s logo, hero, and accent images once. Reference from both the theme and individual content.
Reward art
Reward art
Upload a set of reward images (e.g. four tiered prize visuals). Reuse on tiered rewards, tiered achievements, tiered leaderboards.
API
POST /api/files/upload— upload an image (multipart form fieldfile)DELETE /api/files/upload?url=<blob-url>— delete a previously uploaded image by its public blob URL (Admin+ only)