Account

What new tool do you want?

Developer Tools

BlurHash & ThumbHash Generator

Make BlurHash and ThumbHash placeholders from images, compare how they look, and copy the hash strings or a CSS data-URL placeholder. Batch images to JSON, or paste a hash to see the image it decodes to. Runs in your browser.

How to use

  1. 1Drop one or more images. Each gets a BlurHash and a ThumbHash, shown side by side with the original.
  2. 2Adjust BlurHash detail (components across and down) if you want more or less detail; copy the strings or the CSS placeholder.
  3. 3Download all hashes as JSON, or switch to Hash → image to decode a hash you already have.

Frequently asked questions

BlurHash or ThumbHash: which should I use?

ThumbHash keeps the image's aspect ratio and transparency inside the hash, shows a little more detail and colour, and is usually about the same length. BlurHash is older and has libraries for almost every platform (Swift, Kotlin, Flutter, React Native). If your stack supports ThumbHash, it usually looks better; otherwise BlurHash.

How are they used on a page?

Store the short string with the image's other data (in your database or CMS). When rendering, decode it into a tiny image and show it, blurred and stretched, in the space where the real image will appear; replace it when the real image loads. The CSS line here does that without any JavaScript, using the ThumbHash as a background image.

What do the BlurHash detail sliders do?

BlurHash describes the image with a grid of colour components, 1–9 across and down. 4 × 3 is the usual default for landscape images (3 × 4 for portrait). More components give more detail and a longer hash: 4 × 3 makes 28 characters, 9 × 9 makes 166.

Do I need full-size images?

No. Both hashes only capture a very blurry overview, so the tool works from a small copy (64 px for BlurHash, 100 px for ThumbHash, ThumbHash's maximum input size). The result is the same as from the full image for practical purposes.

Are my images uploaded?

No. Hashes are computed in your browser.

Sources

Why placeholders help

Images are usually the slowest part of a page to arrive. Showing nothing makes the layout look broken; a grey box looks unfinished. A placeholder with the image's real colours, stored as a 20–30 character string, can be sent with the page itself, so something meaningful appears immediately and the sharp image fades in over it.

Example: a product grid

For an online shop's category page, generate hashes for all product photos at once and download the JSON. Add the thumbhash field to each product in your database. In the template, give each product image the CSS placeholder background (decoded from the hash on the server or in the browser) and explicit width and height, so the grid shows coloured blurs straight away and doesn't jump as photos load.

Related tools

More: Developer Tools