/600x400/FF0000/FFFFFF.png
Image Placeholder
Create placeholder image URLs for mockups, frontend pages, and test data.
https://placeholder-api.d-chaser-zsy.workers.dev/600x400/111827/ffffff.png
Image Placeholder Examples
These examples point to the live Cloudflare Worker service and can be used directly as image URLs.
/300
/600x400@2x.png
Documentation
The URL rules are short, stable, and readable. The current API supports custom size, format, color, and Retina output.
Size
Use widthxheight for dimensions. Omit height to generate a square image.
/600x400
/400
Format
SVG is the default format. Add an extension for PNG, JPG, or JPEG output.
/600x400.png
/600x400.jpg
/600x400.jpeg
Colour
Background and foreground colors are passed together. Use hex values, CSS color names, or transparent.
/600x400/000000/ffffff
/600x400/transparent/111827
Retina
Add @2x or @3x after the size for high-density assets.
/600x400@2x.png
/600x400@3x.png
/600x400@2x.jpg
Examples
Combine size, color, format, and Retina scale to generate common placeholder images.
/600x400/FF0000/FFFFFF.png
/600x400/transparent/000000.jpg
Frequently Asked Questions
Common questions about this image placeholder service.
Where should I use this service?
Use it for mockups, frontend pages, Markdown documents, test data, and temporary prototype images.
Is there an image size limit?
Yes. The maximum supported image size is 4000×4000.
Does it support custom text and fonts?
Not yet. The current URL Builder only generates size, color, format, and Retina parameters.
How do transparent backgrounds work?
Use transparent as the background color. PNG keeps transparency; JPEG renders it as white.
How is Retina image size calculated?
/600x400@2x.png returns a 1200×800 image. @3x outputs three times the base size.
Is this service free?
Yes. You can use this service for free without creating an account.