Documentation

Everything you need to know about using Fallback.pics in your projects

Quick Navigation

Getting Started Examples AI Generation Charts

Getting Started

Fallback.pics is a lightning-fast placeholder image service that requires zero setup. Simply use our URLs directly in your HTML, and we'll generate images on-demand.

HTML
<img src="https://fallback.pics/api/v1/400x300" alt="Placeholder">

Result:

Basic placeholder example

Basic Examples

Basic Rectangle

/600x400
Rectangle

Custom Colors

/400x300/3B82F6/FFFFFF
Custom colors

Custom Text

/400x300?text=Product+Image
Custom text

Avatar

/avatar/100?text=JD
Avatar

Color Options

Pro Tip

Colors can be customized using path segments or query parameters. Hex codes should be provided without the # symbol.

Path-based Colors

/400x300/FF6B6B/FFFFFF
Path colors

Format: /width×height/bgColor/textColor

Query Parameter Colors

/400x300?bg=4ECDC4&textcolor=000000
Query colors

Params: bg, bgcolor, textcolor, text_color

AI-Powered Generation

EXCLUSIVE

e-commerce

Mood: energetic
/ai/400x300?context=e-commerce&mood=energetic
e-commerce AI

tech

Mood: calm
/ai/400x300?context=tech&mood=calm
tech AI

healthcare

Mood: professional
/ai/400x300?context=healthcare&mood=professional
healthcare AI

fashion

Mood: vibrant
/ai/400x300?context=fashion&mood=vibrant
fashion AI

finance

Mood: corporate
/ai/400x300?context=finance&mood=corporate
finance AI

food

Mood: warm
/ai/400x300?context=food&mood=warm
food AI

Animated Placeholders

CSS ONLY

skeleton

/animated/skeleton/300x200
skeleton

pulse

/animated/pulse/300x200
pulse

wave

/animated/wave/300x200
wave

shimmer

/animated/shimmer/300x200
shimmer

gradient

/animated/gradient/300x200
gradient

dots

/animated/dots/300x200
dots

Chart Mockups

DATA VIZ

bar Chart

/chart/bar/600x400
bar Chart

pie Chart

/chart/pie/600x400
pie Chart

line Chart

/chart/line/600x400
line Chart

area Chart

/chart/area/600x400
area Chart

donut Chart

/chart/donut/600x400
donut Chart

scatter Chart

/chart/scatter/600x400
scatter Chart

API Reference

Base URL

https://fallback.pics/api/v1

Basic Image

GET /{width}x{height}[.{format}]

Parameters:

  • width - Image width (10-4000)
  • height - Image height (10-4000)
  • format - Optional: svg, png, jpg, webp

Query Parameters

  • text - Custom text to display
  • bg/bgcolor - Background color (hex)
  • textcolor/text_color - Text color (hex)
  • font - Font family
  • size - Font size

Special Routes

/avatar/{size} - Circular avatar
/banner/{width}x{height} - Banner preset
/skeleton/{width}x{height} - Skeleton loader
/ai/{width}x{height} - AI-generated
/animated/{type}/{width}x{height} - Animated
/chart/{type}/{width}x{height} - Chart mockup