Hero

PlacePix Self-Hosted Placeholder Image Service

Self-hosted placeholder image service. Drop images into folders, get instant URLs with resizing, filters, and text overlays.

724 images across 20 categories

One-Line Docker Deploy

Get PlacePix running in seconds with a single Docker command. No configuration needed.

docker run -d -p 3000:3000 -v ./images:/app/images riadvice/placepix:latest

Features:

  • Smart Scan + S3 Support
  • Color extraction
  • Zero Configuration
  • Embedded URL Builder

Smart Crop

Intelligent face-aware cropping. PlacePix detects faces and centers them in the crop area automatically.

Smart crop

Face Detection

?fit=smart
Standard crop

Standard Center Crop

?fit=crop
Cover

Cover Fill

?fit=cover

Aspect Ratios

Pick from common aspect ratios and let PlacePix compute the exact dimensions.

16:9

16:9 Widescreen

/ratio/16:9/400
1:1

1:1 Square

/ratio/1:1/400
9:16

9:16 Portrait

/ratio/9:16/400

Overlays

Add custom text labels and watermarks directly onto your images.

Text overlay

Text Label

?text=Hello+World
Border

Border

?border=4,ffffff
Watermark

Watermark

?watermark=1

Presets

One-click preset dimensions for popular social and screen sizes.

Instagram YouTube Facebook X LinkedIn TikTok Screens

Instagram

Square · Portrait · Story

Build custom
Instagram square

Instagram Square

/preset/instagram-square
Instagram portrait

Instagram Portrait

/preset/instagram-portrait
Instagram story

Instagram Story

/preset/instagram-story

YouTube

Thumbnail · Channel art

YouTube thumbnail

YouTube Thumbnail

/preset/youtube-thumbnail
YouTube banner

YouTube Banner

/preset/youtube-banner
f

Facebook

Cover

Facebook cover

Facebook Cover

/preset/facebook-cover
Facebook shared

Shared Link Preview

/ratio/16:9/720
X

X

Header

X header

Header

/preset/twitter-header
X shared

Link Preview

/ratio/16:9/720
in

LinkedIn

Post

LinkedIn post

LinkedIn Post

/preset/linkedin-post
LinkedIn shared

Shared Preview

/ratio/16:9/720

TikTok

Vertical video

TikTok vertical

TikTok Video (9:16)

/preset/tiktok-video
Square

Square Cut

/ratio/1:1/1080

Screens

Mobile · Tablet · Desktop · 4K

Mobile

Mobile

/preset/mobile
Tablet

Tablet

/preset/tablet
Desktop

Desktop

/preset/desktop
4K

4K

/preset/4k

Categories

Click any size to get a random image from that category

abstract
200×200 400×300 800×600
9

abstract

airplane
200×200 400×300 800×600
3

airplane

animal
200×200 400×300 800×600
52

animal

bird
200×200 400×300 800×600
4

bird

buisness
200×200 400×300 800×600
43

buisness

car
200×200 400×300 800×600
40

car

cat
200×200 400×300 800×600
208

cat

city
200×200 400×300 800×600
66

city

dog
200×200 400×300 800×600
17

dog

education
200×200 400×300 800×600
9

education

flower
200×200 400×300 800×600
38

flower

food
200×200 400×300 800×600
124

food

interior
200×200 400×300 800×600
4

interior

kid
200×200 400×300 800×600
35

kid

medecine
200×200 400×300 800×600
2

medecine

nature
200×200 400×300 800×600
29

nature

space
200×200 400×300 800×600
4

space

sport
200×200 400×300 800×600
9

sport

transportation
200×200 400×300 800×600
6

transportation

travel
200×200 400×300 800×600
22

travel

Random Image Generator

Grab any size from any category — or let PlacePix pick one for you.

400 × 300 800 × 600 1920 × 1080
Random

SVG Placeholder Generator

Zero-processing wireframe placeholders. Perfect for layouts and mockups.

Default
/svg/400/300?bg=e7e5e4&fg=78716c
Custom text
/svg/400/300?bg=1c1917&fg=0ea5e9&text=Hero
Sky CTA
/svg/400/300?bg=0ea5e9&fg=ffffff&text=CTA

Parameters:

bg — background hex color
fg — text hex color
text — custom label (default: width×height)

Gradient Placeholder Generator

Generate linear or radial gradient images on the fly. Perfect for backgrounds and overlays.

Linear gradient

Linear Gradient

/gradient/400/300/3b82f6/10b981
Angled gradient

45° Angle

?angle=45
Radial gradient

Radial Gradient

?gradient_type=radial

Parameters:

/gradient/{w}/{h}/{from}/{to} — gradient endpoint
?angle=45 — linear angle (0-360)
?gradient_type=radial — radial from center

Filters & Effects

Apply filters and color adjustments to any image on the fly.

Sepia

Sepia Tone

?sepia=1
Sky Tint

Sky Tint

?tint=0ea5e9
Brighten

Brighten & Contrast

?brightness=1.3&contrast=1.2
Saturation

High Saturation

?saturation=2.0
Grayscale

Grayscale

?grayscale=1
Dramatic

Dramatic Red

?tint=e11d48&brightness=0.8&contrast=1.3
Invert

Invert Colors

?invert=true
Posterize

Posterize

?posterize=4
Sharpen

Sharpen

?sharpen=1.5
Emboss

Emboss

?emboss=true
Vignette

Vignette

?vignette=0.5

Color Parameters:

?tint=d97706 — hex color overlay
?brightness=1.3 — 0.0 to 2.0
?contrast=1.2 — 0.0 to 2.0
?saturation=2.0 — 0.0 to 2.0
?sepia=1 — warm sepia tone
?grayscale=1 — black & white
?invert=true — invert colors
?posterize=4 — color levels (1-8)
?solarize=128 — threshold (0-255)
?duotone=ff0000,0000ff — two-color map

Effect Parameters:

?sharpen=1.5 — sharpen amount
?emboss=true — 3D relief effect
?halftone=4 — dot pattern
?edges=sobel — edge detection
?edges=canny — Canny edges
?oil_painting=true — oil painting style
?pencil_sketch=true — pencil sketch
?cartoon=true — cartoon effect
?vignette=0.5 — darken edges (0-1)

API Reference

All endpoints support CORS and return images with long-term cache headers.

GET /{width}/{height}/{category}

Random image from a category

GET /{width}/{height}

Random image from all categories

GET /health

Health check (liveness probe for Docker/K8s)

GET /ready

Readiness check (returns 503 until images loaded)

Query Parameters

?grayscale=1Grayscale
?blur=2Gaussian blur (1-10)
?seed=abcDeterministic image
?text=HelloText overlay
?fit=cropResize mode
?base64=1Return base64 JSON (max 256px)
.avifAVIF output (smaller)
.webpWebP output
.pngPNG output (lossless)

Figma Integration

Embed live PlacePix images directly in your Figma designs using iframe embeds.

Paste this iframe code into Figma as an embedded URL:

<iframe src="https://your-placepix-instance.com/800/600/nature?seed=figma" width="800" height="600" frameborder="0"></iframe>

Replace your-placepix-instance.com with your actual PlacePix URL.

Tips:

• Use ?seed=xyz for consistent images
• Adjust width/height in both URL and iframe attributes
• Add ?grayscale=1 for wireframe mode
• Use /gradient/ for placeholder backgrounds