Jérôme Mahuet's Blog

A generator of fake images

When designing websites, you may not have the images you need at first. But you already know the sizes and inserting some placeholders can help you better seeing the layout. Don’t waste your time making dummy images for your mockup or wireframe. Fakeimg.pl is a little tool that generates images with an URL. Choose the size, the colors, even the text. It’s free and open-source.

How to use

You just have to put your image size after our URL. Only the first parameter is mandatory. There are options too, you can pass a text, or change some colors. Colors must be hexadecimal, the first one is the background color. The text can be passed with the text GET variable. Here are some examples you can look at:

1<img src="https://fakeimg.pl/300/"> 2<img src="https://fakeimg.pl/250x100/"> 3<img src="https://fakeimg.pl/250x100/ff0000/"> 4<img src="https://fakeimg.pl/350x200/ff0000/000"> 5<img src="https://fakeimg.pl/350x200/?text=Hello"> 6<img src="https://fakeimg.pl/350x200/?text=オラ&font=noto"> 7<img src="https://fakeimg.pl/350x200/?text=World&font=lobster">

Use them directly in an image tag or a CSS background, or whatever you want to.

Change font

There are three bonus fonts you can choose by passing font=lobster, font=bebas, or font=museo in the URL. Also please note that the font=noto is available for chinese/japanese/korean texts.

Change font size

You can manually change the font size by passing in the URL font_size=12.

Retina mode

Just pass the retina=1 in the URL. Your image will be 2 times bigger.

Asian text support

You can use the font noto for support of japanese, korean and chinese text.


Colors support transparency (0 - 255) by putting the alpha value after the color itself. Both colors are supported.

1<img src="https://fakeimg.pl/350x200/ff0000,128/000"> 2<img src="https://fakeimg.pl/350x200/ff0000,128/000,10">

Set up your own instance


  • Docker
1# Run the image (change the port if you need) 2$ docker run -d -p 80:80 rydgel/fakeimg:latest 3# Open the browser at

Source and website

The website can be found here: fakeimg.pl and the source code here.

Made in France in 2024 with NextJS, Typescript, Strapi, Tailwind etc.