Skip to main content
The Asset Library (#1661) stores your uploaded images in one place so you can reuse them across challenges, rewards, posts, and themes — no more re-uploading the same hero image five times.

​
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

Use the crop tool to fit recommended ratios at upload time and avoid distortion at render time.

​
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

Upload a banner for a challenge series; reuse on each challenge in the series. Visual coherence without re-uploads.
Upload your brand’s logo, hero, and accent images once. Reference from both the theme and individual content.
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 field file)
  • DELETE /api/files/upload?url=<blob-url> — delete a previously uploaded image by its public blob URL (Admin+ only)
Both routes are auth-gated via the admin session. Library listing/browsing is handled by the admin UI on top of Vercel Blob — there is no public “list assets” endpoint.