/img/600x400/c28a3d/FFFFFF.png
✦ Fast Image Placeholder Service
Image Placeholder
Create image placeholder URLs for mockups, frontend pages, and test data.
GET
https://image-placeholder.net/img/600x400/111827/ffffff.png
Image Placeholder Examples
These examples point to the live Cloudflare Worker service and can be used directly as image URLs.
/img/300.png
/img/600x400@2x.png
What is image placeholder
An image placeholder is a temporary image used while a final photo, graphic, or product asset is not ready. It keeps layouts stable, helps designers and developers test image sizes, and makes mockups easier to review.
With an image placeholder URL, you can set the width, height, color, and format directly in the link. That makes it useful for websites, apps, documentation, test data, and quick frontend prototypes.
How to insert an image placeholder in your project
Copy an image placeholder URL from the generator and use it anywhere an image source is accepted. For HTML, paste it into an img tag. For CSS, use it as a background image. For Markdown, place it in standard image syntax.
<img src="https://image-placeholder.net/img/600x400.png" alt="image placeholder">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.
/img/600x400
/img/400Format
SVG is the default format. Add an extension for PNG, JPG, or JPEG output.
/img/600x400.png
/img/600x400.jpg
/img/600x400.jpegColour
Background and foreground colors are passed together. Use hex values, CSS color names, or transparent.
/img/600x400/000000/ffffff
/img/600x400/transparent/111827Retina
Add @2x or @3x after the size for high-density assets.
/img/600x400@2x.png
/img/600x400@3x.png
/img/600x400@2x.jpgExamples
Combine size, color, format, and Retina scale to generate common image placeholder.
/img/600x400/FF0000/FFFFFF.png
/img/600x400/transparent/000000.jpgFrequently 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 10×10 to 2000×2000.
Does it support custom text and fonts?
Not yet. The current URL generator 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?
/img/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.