---
title: "Images and lightbox"
url: "/help/buuk/images-and-lightbox"
updated: "2026-10-22T11:13:34.594Z"
---
# Images and lightbox

Screenshots make a step obvious when words are not enough. Images live inside the article, compress automatically, and open in a lightbox for readers.

> [!NOTE]
> For screenshots Buuk captures from your product while drafting, see [Images and screenshots](./images-and-screenshots).

## Add an image

1. Press `/` in the editor and choose **Image**.
2. Pick a PNG, JPG, WebP, or GIF file from the picker that opens.
3. Publish the article when the copy and images are ready.

Every upload lands in your draft only. Nothing publishes on its own, and the file appears on the public page **only after you publish the article**.

## Compression

Buuk compresses images in your browser before they upload. Pictures wider than 1,920 px are scaled down, and most JPEG and WebP files are re-encoded at high quality when the smaller version saves space.

Small files already under about 400 KB upload as-is, and GIF files are never re-encoded, so animated GIFs stay animated.

> [!NOTE]
> A single image can be up to 24 MB. Larger files are rejected with a message telling you to try a smaller image.

## Alt text

When you upload an image, Buuk sets its alt text to the file name. That text appears as a caption under the image on the public page and is the label screen readers and the enlarge button use.

Describe the screen in the file name before you upload — `export-settings.png` instead of `image-3.png`.

## Annotate

Select an image in the editor and choose **Annotate** to blur, crop, or draw arrows on a canvas. Saving uploads the marked-up version as a new PNG and swaps it into the article, so the original bytes stay untouched.

## On the public page

Readers see images in place, lazy-loaded. Clicking one opens a lightbox with an enlarged view — the cursor shows a magnifier, and a close button returns to the article.

## Related

- Read [Images and screenshots](./images-and-screenshots) for AI-captured product screenshots.
- See [Videos](./videos) for uploaded video files.
- Browse the full block list in [Editor blocks](./editor-blocks).
- Check the publishing loop in [Write and publish an article](./write-and-publish-an-article).