# ImageNow

> URL-driven placeholder image generator API created by LiquidPixels.

ImageNow is a free URL-based placeholder image API created by LiquidPixels. Create images by putting size, colors, format, DPR, and text directly in the URL for frontend development, CMS testing, QA states, ad mockups, Open Graph previews, and visual documentation.

## Canonical URL

https://imagenow.dev

## Core Syntax

GET /{size}/{background}/{foreground}.{format}?text={text}

## Size Tokens

| Syntax | Meaning |
| --- | --- |
| `/1200x630` | Explicit width and height in pixels. |
| `/512` | Square shorthand for 512x512. |
| `/640x4:3` | Width with derived height from a 4:3 aspect ratio. |
| `/16:9x1080` | Height with derived width from a 16:9 aspect ratio. |
| `/hd720` | Named preset size keyword. |
| `/300x250@2x` | DPR multiplier for 2x physical pixel density. |

## Formats

- webp
- png
- jpeg
- jpg
- gif
- avif

## Fonts (22)

Optional `?font=` query parameter. Available values:

- Inter-Regular
- Roboto-Regular
- OpenSans-Regular
- Lato-Regular
- Montserrat-Regular
- Poppins-Regular
- Nunito-Regular
- WorkSans-Regular
- Barlow-Regular
- Rubik-Regular
- DMSans-Regular
- PlayfairDisplay-Regular
- Merriweather-Regular
- Lora-Regular
- EBGaramond-Regular
- SourceCodePro-Regular
- FiraCode-Regular
- JetBrainsMono-Regular
- IBMPlexMono-Regular
- Oswald-Regular
- Raleway-Regular
- SpaceGrotesk-Regular

## Behavior And Limits

- Generated image URLs use the pattern /{size}/{background}/{foreground}.{format}?text={text}.
- Size tokens support explicit dimensions, square shorthand, width plus aspect ratio, aspect ratio plus height, named presets, and @2x, @3x, or @4x DPR multipliers.
- Hex color path segments may be supplied without #. Invalid or missing colors fall back to defaults.
- Supported extensions are webp, png, jpeg, jpg, gif, and avif. Unsupported extensions fall back to WebP.
- Unsupported size routes are not generated and use the normal 404 page.
- Rendered width and height are clamped to 9999 physical pixels.
- Text is URL-decoded, normalized, and truncated to 160 characters.
- Generated image responses are CORS-enabled and cached as public, max-age=31536000, immutable.

## Canonical Examples

| Task | URL | Description |
| --- | --- | --- |
| Open Graph | https://my.imagenow.dev/1200x630/0f172a/f8fafc.png?text=Open+Graph | 1200x630 social preview placeholder. |
| Medium Rectangle | https://my.imagenow.dev/300x250/111827/f8fafc.webp?text=Medium+Rectangle | IAB 300x250 ad placeholder. |
| Leaderboard | https://my.imagenow.dev/728x90/1f2937/e5e7eb.gif?text=Leaderboard | 728x90 leaderboard ad placeholder. |
| Avatar | https://my.imagenow.dev/512/334155/e2e8f0.png?text=Avatar | Square avatar or profile placeholder. |
| Video | https://my.imagenow.dev/16:9x1080/111827/22d3ee.jpeg?text=Video | 16:9 full HD video frame placeholder. |
| Mobile | https://my.imagenow.dev/9:19x844/111827/22d3ee.jpeg?text=Mobile | Tall mobile mockup placeholder. |
| HD Preview | https://my.imagenow.dev/hd720/0f172a/f8fafc.png?text=HD+Preview | Named 1280x720 preset placeholder. |
| Full HD | https://my.imagenow.dev/hd1080/0f172a/f8fafc.png?text=Full+HD | Named 1920x1080 preset placeholder. |
| Retina | https://my.imagenow.dev/300x250@2x/111827/f8fafc.png?text=Retina | 2x physical density placeholder. |
| Docs | https://my.imagenow.dev/640x4:3/2563eb/ffffff.webp?text=Docs | Width plus ratio documentation placeholder. |

## FAQ

### What is ImageNow?

ImageNow is a free URL-based placeholder image API for developers. It creates generated images from URL path parameters for size, colors, format, DPR, and optional text.

### How do I generate a placeholder image?

Use a URL like /1200x630/0f172a/f8fafc.png?text=Open+Graph. The first segment is the size, the next two are background and foreground colors, and the extension selects the output format.

### Which image formats are supported?

ImageNow supports the following formats: webp, png, jpeg, gif, and avif. Unsupported formats fall back to WebP.

### Can I use ImageNow without an account?

Yes. ImageNow is designed as a no-account, no-setup placeholder image service.

### Are generated images cached?

Generated image are cached at the CDN level with a generous cache policy.

### Who built ImageNow?

ImageNow is built on LiquiFire OS — LiquidPixels' dynamic imaging platform — delivering unmatched power and flexibility.

## Ad Sizes

| Keyword | Shortcut | Dimensions | Usage |
| --- | --- | --- | --- |
| `mediumrectangle` | `medrect` | `300x250` | IAB 300x250 display ad unit |
| `squarepopup` | `sqrpop` | `250x250` | Square popup creative or square ad slot |
| `verticalrectangle` | `vertrec` | `240x400` | Sidebar ad creative |
| `largerectangle` | `lrgrec` | `336x280` | Content card ad placement |
| `rectangle` | `rec` | `180x150` | Compact module thumbnail |
| `popunder` | `pop` | `720x300` | Wide promotional banner |
| `fullbanner` | `fullban` | `468x60` | Legacy horizontal banner |
| `halfbanner` | `halfban` | `234x60` | Compact horizontal banner |
| `microbar` | `mibar` | `88x31` | Micro badge or affiliate badge |
| `button1` | `but1` | `120x90` | Large CTA-style button graphic |
| `button2` | `but2` | `120x60` | Compact CTA/button graphic |
| `verticalbanner` | `vertban` | `120x240` | Tall side-rail ad slot |
| `squarebutton` | `sqrbut` | `125x125` | Square icon tile or promo badge |
| `leaderboard` | `leadbrd` | `728x90` | Top-of-page leaderboard ad |
| `wideskyscraper` | `wiskyscrpr` | `160x600` | Wide tall sidebar ad |
| `skyscraper` | `skyscrpr` | `120x600` | Narrow tall sidebar ad |
| `halfpage` | `hpge` | `300x600` | Half-page ad creative |

## Screen Standards

| Keyword | Shortcut | Dimensions | Usage |
| --- | --- | --- | --- |
| `cga` |  | `320x200` | Retro or embedded display mock |
| `qvga` |  | `320x240` | Low-resolution mobile screen mock |
| `vga` |  | `640x480` | Standard 4:3 app or screen mock |
| `wvga` |  | `800x480` | Wide mobile display mock |
| `svga` |  | `800x600` | Legacy desktop screen mock |
| `wsvga` |  | `1024x600` | Netbook or compact laptop mock |
| `xga` |  | `1024x768` | Presentation slide or 4:3 desktop |
| `wxga` |  | `1280x800` | Laptop widescreen mock |
| `wsxga` |  | `1440x900` | Desktop widescreen mock |
| `wuxga` |  | `1920x1200` | Large desktop or app mock |
| `wqxga` |  | `2560x1600` | High-density monitor mock |

## Video Standards

| Keyword | Shortcut | Dimensions | Usage |
| --- | --- | --- | --- |
| `ntsc` |  | `720x480` | SD video frame mock |
| `pal` |  | `768x576` | PAL SD video frame mock |
| `hd720` |  | `1280x720` | HD video or social preview |
| `hd1080` |  | `1920x1080` | Full HD video or social preview |

## Device Viewports

| Keyword | Shortcut | Dimensions | Usage |
| --- | --- | --- | --- |
| `iphone15` |  | `393x852` | iPhone 15 viewport |
| `iphone15pro` |  | `393x852` | iPhone 15 Pro viewport |
| `iphonese` |  | `375x667` | iPhone SE viewport |
| `ipad` |  | `820x1180` | iPad viewport |
| `ipadpro` |  | `1024x1366` | iPad Pro viewport |
| `pixel8` |  | `412x924` | Google Pixel 8 viewport |
| `galaxys24` |  | `360x780` | Samsung Galaxy S24 viewport |

## Social And OG

| Keyword | Shortcut | Dimensions | Usage |
| --- | --- | --- | --- |
| `ogimage` |  | `1200x630` | Open Graph / Facebook share image |
| `twittercard` |  | `1200x628` | X / Twitter card image |
| `instasquare` |  | `1080x1080` | Instagram square post |
| `instastory` |  | `1080x1920` | Instagram / TikTok story |
| `ytthumb` |  | `1280x720` | YouTube thumbnail |
| `linkedinbanner` |  | `1584x396` | LinkedIn profile banner |

## App Icons

| Keyword | Shortcut | Dimensions | Usage |
| --- | --- | --- | --- |
| `iosicon` |  | `180x180` | iOS touch icon |
| `androidicon` |  | `512x512` | Android adaptive icon |
| `favicon` |  | `32x32` | Browser tab icon |
| `appicon` |  | `1024x1024` | App Store / Play Store icon |