DummyImg Image API

Free dummy image API

Dummy image generator: a placeholder image of any size from one URL.

Set the width, height, text, colors, font and format, then copy a ready-to-use dummy image URL or download the image. No sign-up, no API key.

/placeholder inline image /download attachment
Size
Text
Appearance
Background Image

Live preview

Generated image

300 x 200 PNG
300 x 200 dummy image
Open image

API reference

Dummy image URL examples

Use the /placeholder endpoint as a dummy image API with variables like width, height, text, bg_color, text_color, format, font_size, font_style, text_position, and bg_image_url. Public calls still work without login. To attach calls to your account, add token=<user id> to the image URL.

Custom size

https://www.dummyimg.in/placeholder?width=600&height=400

Text label

https://www.dummyimg.in/placeholder?text=Hello%20World

Hex colors

https://www.dummyimg.in/placeholder?bg_color=%23245bd8&text_color=%23ffffff

Download

https://www.dummyimg.in/download?width=1200&height=630&format=WEBP

Tracked

https://www.dummyimg.in/placeholder?width=600&height=400&token=<user-id>
Supported query parameters
Parameter Default Accepted values
width, height 300, 200 Numbers from 10 to 3000
text Image size Text up to 240 characters
bg_color, text_color lightgray, white CSS color names or hex colors
font_size Auto Numbers from 1 to 512
format PNG PNG, JPEG, JPG, WEBP, GIF, BMP
text_position center Center, edges, and corner positions
font_style arialuni arial, arialuni, comic, comicy, disko, comic-queens
bg_image_url None A readable image URL
token None Your profile URL token for account usage tracking

How to use it

How to use a dummy image URL

A dummy image URL works anywhere an image URL works. Paste it into your HTML, CSS, React components, Markdown docs or test fixtures, and change width and height to match the slot you are filling.

HTML
<img src="https://www.dummyimg.in/placeholder?width=600&height=400"
     width="600" height="400" alt="Product photo placeholder">
CSS background
.hero {
  background-image: url("https://www.dummyimg.in/placeholder?width=1920&height=600&text=Hero");
  background-size: cover;
}
React / JSX
<img
  src={`https://www.dummyimg.in/placeholder?width=${w}&height=${h}`}
  alt="Avatar placeholder"
/>
Markdown
![Screenshot placeholder](https://www.dummyimg.in/placeholder?width=800&height=450&text=Screenshot)

Ready-made links

Common dummy image sizes

Copy a dummy image URL for the most common placeholder sizes, or set any size from 10 to 3000 pixels in the generator above.

Grey 600 x 400 dummy image
600 x 400 dummy image
Blue 1200 x 630 dummy image for social previews
1200 x 630 social preview
Orange 640 x 360 test image with a custom label
640 x 360 with custom text
Dark 1920 x 1080 dummy image in WEBP format
1920 x 1080 WEBP

Thumbnail · 150 x 150

https://www.dummyimg.in/placeholder?width=150&height=150

Avatar / profile · 100 x 100

https://www.dummyimg.in/placeholder?width=100&height=100

Card image · 400 x 300

https://www.dummyimg.in/placeholder?width=400&height=300

Blog / Open Graph · 1200 x 630

https://www.dummyimg.in/placeholder?width=1200&height=630

HD video 16:9 · 1280 x 720

https://www.dummyimg.in/placeholder?width=1280&height=720

Full HD banner · 1920 x 1080

https://www.dummyimg.in/placeholder?width=1920&height=1080

Instagram post · 1080 x 1080

https://www.dummyimg.in/placeholder?width=1080&height=1080

Leaderboard ad · 728 x 90

https://www.dummyimg.in/placeholder?width=728&height=90

FAQ

Dummy image questions

What is a dummy image?

A dummy image is a stand-in picture used while the real image isn't ready yet. It holds the right width and height in a layout, mockup or test so the design doesn't shift when the final image arrives.

How do I get a dummy image URL?

Use https://www.dummyimg.in/placeholder and add the size you need, for example https://www.dummyimg.in/placeholder?width=600&height=400. Any page, app or test can load that link like a normal image.

Is DummyImg free? Do I need an API key?

Yes, it's free, and you don't need an API key or an account. Signing up is optional and only adds usage tracking for your own requests.

Which image formats and sizes are supported?

PNG, JPEG, WEBP, GIF and BMP, in any size from 10 to 3000 pixels wide and tall. Set the format with format=WEBP, for example.

Can I add custom text and colors?

Yes. Add text=Your%20Text for the label, and bg_color and text_color with a CSS color name or a hex code (encode # as %23), for example bg_color=%23245bd8.

How do I download a dummy image instead of linking to it?

Use the /download endpoint with the same options, for example https://www.dummyimg.in/download?width=1200&height=630&format=PNG, or press Download in the generator above.

Can I use these dummy image URLs as sample image URLs for testing?

Yes. Every URL returns a real image with a stable size, so it works for unit tests, API mocks, seed data, Storybook stories and broken-image fallbacks.

Guides

More dummy image guides