Placeholder images

One URL. Relevant images. No signup.

Use the OKSLOP placeholder endpoint directly in HTML, Markdown, CSS, or generated code. Add a topic for relevance and a seed when the image should stay stable across page loads.

<img
  src="https://okslop.com/img/random?query=cozy%20workspace&seed=hero"
  alt="Cozy workspace"
/>

Canonical URL

The canonical public path is /img/random. The shorter /placeholder alias permanently redirects to the canonical path and preserves its size segment and query parameters.

https://okslop.com/img/random/{size}?query={topic}&orientation={orientation}&seed={seed}

Build the URL you need

query

Topic or natural-language subject, such as office or dentist waiting room.

seed

Stable choice. The same topic and seed select the same image.

orientation

landscape, portrait, or square.

size

xs, thumb, preview, full, or original. Use it as a path segment or query parameter.

<!-- Topic-relevant, different choice on each uncached request -->
<img src="https://okslop.com/img/random?query=dentist%20office" alt="Dentist office" />

<!-- Stable topic-relevant hero -->
<img src="https://okslop.com/img/random/full?query=forest%20cabin&seed=home-hero" alt="Forest cabin" />

<!-- Portrait thumbnail -->
<img src="https://okslop.com/img/random/thumb?query=chef&orientation=portrait&seed=author" alt="Chef" />

Determinism and caching

Add seed when a slot must keep the same selection. Seeded redirects are cacheable for 24 hours. Unseeded redirects use no-cache so they can rotate.

Sizes

Choose from xs (200px), thumb (400px), preview (800px, default), full (2000px), or original. Arbitrary resizing is not performed at request time.

License and disclosure

OKSLOP images are AI-generated. The OKSLOP license permits free commercial and non-commercial use without required attribution, subject to its restrictions and your responsibility to review each image for your use case. Read the full license and AI disclosure.

Replacing source.unsplash.com?

Keep the one-line image workflow, then add a seed if the chosen image should remain stable.

See the URL migration guide →