Placeholder Image Service v2.0

A local, self-hosted placeholder image service compatible with placehold.co URL patterns.

Size

Specify width x height — height is optional (defaults to square).

600x400
/600x400
/400

Min: 10x10 — Max: 4000x4000

Format

Append a format as a path segment or file extension. Default is SVG.

/600x400/png   /600x400.png

Supported: svg png jpeg gif webp avif

Colours

Set background and text colours using hex values or CSS colour names.

black bg
/300x120/000000/FFF
/300x120/orange/white

Custom Text

Use the ?text= query param. Spaces: +, newlines: \n.

Hello World /400x150?text=Hello+World

Font

Use ?font=roboto. Available: lato, lora, montserrat, noto-sans, open-sans, oswald, playfair-display, poppins, pt-sans, raleway, roboto, source-sans-pro.

Retina

Append @2x or @3x for higher-density raster images.

/600x400@2x.png   /300@3x.png

Examples

URLDescription
/600x400600×400 SVG
/250250×250 square SVG
/600x400.png600×400 PNG
/600x400/EEE/31343CCustom colours
/600x400/orange/white/pngCSS colours + PNG
/600x400?text=Hello+WorldCustom text
/600x400?text=Line+1\nLine+2Multi-line text
/800@2x.pngRetina 2x PNG