Image guides

Create and check a BlurHash placeholder

·

A BlurHash stores a small description of the colors and broad shapes in an image. Decode it while the full image loads.

BlurHash Generator

Generate a 28-character hash from the example

Choose Load example. Keep four horizontal and three vertical components and a white backdrop. Select Generate BlurHash. The sampled image is 8 × 4 and its stored average color is #DFCBC6.

Read the decoded preview. The broad blocks remain visible as gradients. Copy the 28-character string or use Download BlurHash text to save it.

Wolt, BlurHash algorithm and Base83 structureWolt, BlurHash reference implementations

Choose the detail on each axis

Move the horizontal slider to change detail across the width. Move the vertical slider to change detail down the height. A lower count produces a shorter string, and 1 × 1 retains only the average color.

The string has four characters plus twice the horizontal component count times the vertical count.

Choose the detail on each axis
ComponentsString lengthResult
1 × 16Average color
4 × 328Horizontal and vertical detail
9 × 9166More detail on both axes

Wolt, BlurHash algorithm and Base83 structure

Store the string with your image

Put the downloaded or copied string next to the source image reference in your project. Use a BlurHash-compatible renderer and match the placeholder’s aspect ratio to the image.

A dark backdrop changes how transparent source pixels contribute. Pick the backdrop your page uses, generate again and verify the decoded PNG before choosing the string.

Wolt, BlurHash reference implementationsWolt, BlurHash algorithm and Base83 structure

Common questions

Can the string restore the original photo?

BlurHash describes low-frequency colors. Keep the original photo as a separate image.

What is the PNG preview for?

The PNG shows the decoded approximation. The short text string is the value to give a compatible placeholder renderer.

Sources

Put it into practice.

Related guides