Free Placeholder Image Generator & API

FPOImg is a free placeholder image API for developers and designers. Generate images for wireframes, prototypes, and CMS layouts using a URL. Customize dimensions, colors, gradients, and text without an account or API key.

Get PNG, JPEG, WebP, or SVG images. Read the API reference for supported dimensions, formats, and examples.

Gradient placeholder example

Image Generator

placeholder
<img src=" https://fpoimg.com/800x600?bg_color=eeeeee&text_color=333333 ">

How to Use

URL Pattern

Generate placeholder images by using a simple URL pattern:

https://fpoimg.com/{width}x{height}?text={caption}&bg_color={bg_color}&text_color={text_color}

Basic Usage
https://fpoimg.com/800x600

Creates an 800×600 pixel image with default colors.

With a caption
https://fpoimg.com/800x600?text=Caption

Creates an 800×600 pixel image with a caption

Custom Colors
https://fpoimg.com/400x300?bg_color=4361ee&text_color=ffffff

Creates a 400×300 pixel image with blue background and white text.

Square Image
https://fpoimg.com/500

Creates a 500×500 pixel square image.

Gradient Background
https://fpoimg.com/800x600?gradient=sunset&text_color=ffffff

Creates an 800×600 image with a sunset gradient and white text.

Custom Gradient
https://fpoimg.com/400x300?gradient=FF5733,3357FF&gradient_angle=45

Creates a 400×300 image with a custom two-color gradient at 45°.

Named Colors
https://fpoimg.com/400x300/tomato/white

Use CSS color names instead of hex codes — in the URL path or as query params.

Named Colors (Query Params)
https://fpoimg.com/400x300?bg_color=steelblue&text_color=white

Works with bg_color, text_color, and even gradients.

Multiline Text
https://fpoimg.com/400x300?text=Line+1\nLine+2

Use \n for line breaks. Long text auto-wraps to fit the image.

Hide Dimensions
https://fpoimg.com/800x600?dims=false

Hide the dimension label for a clean placeholder. Captions still render if provided.

Example Use Cases

Web Development

Perfect for prototyping websites before final images are ready.

Try for your website →

Design Mockups

Use as placeholders in design mockups and presentations.

Create mockup images →

CMS Content

Generate temporary images for CMS sites and blog posts.

Generate CMS images →

Independent & open source

Useful in your work? Help support FPOImg.

I'm Kyle Hayes, the developer behind FPOImg. I maintain it as a free, open-source tool for designers and developers. If it saves you time in a mockup, template, or side project, a small contribution helps me maintain it and make it better.

Sponsor the project

Use FPOImg regularly or as part of your team's workflow? Support its ongoing development through GitHub Sponsors.

Sponsor on GitHub

Say thanks with a coffee

Found FPOImg handy for a project? Send a small thank-you through Buy Me a Coffee.

Buy me a coffee

Support is optional. The image generator and URL API are free to use.

You can also help by contributing on GitHub: report a bug, suggest an improvement, or contribute code.

We use Google Analytics to measure site visits, generator actions, and support-link clicks. Google Analytics uses cookies. How Google uses information from this site.