Using CDN URLs
URL Structure
https://cdn.hackclub.com/{id}/{filename}
Requests are 301 redirected to the underlying storage bucket.
Embedding
Images
<img src="https://cdn.hackclub.com/019505e2-c85b-7f80-9c31-4b2e5a8d9f12/photo.jpg" alt="">
Links
<a href="https://cdn.hackclub.com/019505e2-d4a1-7c20-8b45-6e3f2a1c8d09/document.pdf">Download</a>
Markdown
Security
Upload IDs contain 74 bits of cryptographic randomness (UUID v7, via the OS CSPRNG). There's no file listing or directory index. URLs are safe to use for unreleased programs.
Hotlinking
Supported. URLs can be embedded in GitHub, Notion, Discord, Slack, etc.
Content-Type
Served based on file extension.
URL Rescue
Lookup endpoint for files migrated from legacy CDNs:
GET /rescue?url={original_url}
Examples:
/rescue?url=https://hc-cdn.hel1.your-objectstorage.com/s/v3/sdhfksdjfhskdjf.png
/rescue?url=https://cloud-xxxx-hack-club-bot.vercel.app/0awawawa.png
Returns 301 redirect to the new CDN URL if found. For image URLs (.png, .jpg, .jpeg), returns an SVG 404 placeholder if not found. Otherwise returns HTTP 404.