DOCUMENTATION

Image

Last updated May 2026
Media Block
All plans

Upload or embed an image with full positioning, zoom, flip, and display mode controls. Five display modes let you go beyond a plain image — apply real-time dithering or ASCII art rendering directly in the editor and on published pages.

Adding an image

/ → Image
Type /image on any empty block and press Enter. A file picker or URL input appears.
Drag and drop
Drag an image file directly onto any empty block or between blocks.
Paste
Paste an image file or URL from clipboard into an empty block.
Block palette
Click + on any block → Media → Image.

Display modes

Default
Standard image rendering with optional caption below. Object fit is configurable.
Clean
No chrome, no caption — just the image. Best for inline illustrations and diagrams.
Overlay
A color/gradient overlay renders on top of the image. Configure color, opacity, and blend mode from the settings panel.
Dither
Applies a real-time dithering shader to the image. Same dither engine used in the Hero block — configurable pattern (Bayer, Halftone, Noise, Crosshatch), color mode, and grid size.
ASCII
Converts the image into a live ASCII character grid. Configurable character set, text color, column resolution, and animation style.
Dither and ASCII modes run as a live canvas effect using the same rendering pipeline as the Hero block's background effects — in the editor and, by default, on published pages too. An Export as static image button (in the Dither/ASCII settings panel) lets you bake the current look to a static PNG instead — see Static export below.

Static export for Dither/ASCII

Live dither/ASCII rendering costs real CPU on every visitor's device — for a published page where the settings won't keep changing, baking it to a static image is faster and lighter. Click Export as static image in the settings panel: the current canvas frame is captured and uploaded, and the published page renders that static image instead of mounting the live effect. The button relabels to Re-export static image once an export exists.

Exporting is a manual snapshot, not a live sync — changing any dither/ASCII setting afterward does not automatically re-export. Click Re-export static image again after making changes, or the published page keeps showing the older look. The editor always shows the live effect regardless of whether a static export exists, so what you see while editing is never affected.

Positioning and zoom

The Zoom, Flip, and Position controls are always present in the settings panel, regardless of the object fit mode — they are not gated behind Cover. Click and drag directly on the position thumbnail to set the focal point, or use the X/Y sliders for fine control.

A Zoom slider (100–300%) scales the image relative to "exactly cover" the container. At 100% the image fits with no excess. Increasing zoom gives the position controls more room to pan. Axes with no overflow are shown as locked — increase zoom to unlock them. There are no position preset pills — only the drag pad and the two sliders.

Flip

Mirror the image horizontally (H), vertically (V), or both axes simultaneously. Toggles are independent.

Background removal

A Remove background button runs background removal on the image and swaps in the processed result. A Restore original button reverts to the unprocessed image.

This runs server-side (no AI key required) — an earlier client-side/WASM version was replaced after proving unreliable across browsers. The trade-off is a short server round-trip instead of instant local processing, but it now works consistently everywhere.
Capped at 20 removals per hour per account — this is the one image operation that spends BlnkSpace’s own compute rather than your own API key, so it’s rate-limited like other shared-compute features. If you hit the limit, wait for it to reset rather than re-clicking Remove background repeatedly.

Settings reference

SettingOptions
SourceUpload file or paste URL
Display modeDefault, Clean, Overlay, Dither, ASCII
Object fitContain, Cover, Fill
PositionDrag control + X/Y sliders (always shown, not fit-dependent)
Zoom100–300% (always shown, not fit-dependent)
FlipNone, H, V, Both
Background removalRemove background / Restore original — no separate settings
Static exportExport as static image / Re-export static image — Dither/ASCII modes only
CaptionShown below the image in Default mode only
WidthAuto or custom px (drag right handle)
HeightAuto or custom px (drag bottom handle)
There is no alt text field in the settings panel. Alt text is stored in metadata and used for the rendered <img alt> attribute, but nothing in the UI currently lets you set it directly.