IMAGE(1)
![]()
Image Placeholder Generator
Name
image — placeholder images at any size, color, text and format
Synopsis
GET https://placehold.cloud/WxH [?text=str] [&bg=hex] [&fg=hex]
GET https://placehold.cloud/p/WxH/bg/fg [?format=fmt] [&text=str] [&font=name] [&quality=n]
Options
- size
- Dimensions, e.g. 300x200, or 300 for a square.
- format
- png, jpg, webp, avif, gif, bmp, ico or svg.
- bg
- Background hex color. Default C8C8C8.
- fg
- Text hex color. Default 323232.
- text
- Overlay text. Default "Placeholder".
- font
- arial, couri, times or tron.
- quality
- Compression quality, 1–100.
- grayscale, invert
- Filters; pass true to apply.
- cat, dog, robot
- Use a photo or robot instead of a flat color; pass true.
Examples
A 640×320 banner with a caption:
$ curl -O "https://placehold.cloud/640x320?text=Hello&bg=efefef&fg=374151"
Orange PNG, white text:
$ curl -O "https://placehold.cloud/p/300x200/FF5733/FFFFFF?format=png&text=Hello"
Try it
url
html
md
Caching
Responses are cached for a day (max-age=86400), so repeat requests are fast.