Asset library

Every image you upload while editing an email lands in your account's asset library, where you can browse and reuse it later. There is no separate upload page: the library fills up as you add images to emails, and the same library appears wherever the editor offers an Image field.

Where the asset library lives

The library is reached through the block editor, not a standalone screen. When you select an image block in the Content step of the composer at /campaigns/[id]/compose, the settings panel shows an Image field with a URL box and two buttons: Upload and Browse.

The same image control appears in other places that take an image: a row's Background image, the footer block's logo, and the video block's Thumbnail image. They all read from and write to the same account library, so an image uploaded in one place is available everywhere else. The same control is also available in the template editor.

The brand kit editor's logo uploader writes to this same library, so logos you upload there can later be browsed from an image block. The brand kit uploader has its own controls and does not offer a Browse button of its own.

Adding an image to the library

Select an image block, then click Upload and choose a file. The button reads "Uploading…" while the file is processed and stored, then the block points at the new image and the file joins your library.

Uploads must be one of four image types: PNG, JPEG, GIF, or WebP. Any other type is rejected with "Unsupported image type — use PNG, JPEG, GIF, or WebP." The raw file must be 10MB or smaller; a larger file returns "Image is larger than 10MB."

If image processing fails — for example, the file is corrupted — the upload returns "Could not process the image." The URL box next to the buttons is always available, so you can paste a link to an externally hosted image instead of uploading.

Browsing and reusing images

Click Browse to open the Asset library dialog, a grid of your account's uploaded images shown as square thumbnails. Click any thumbnail to drop that image into the block you are editing — the dialog does not upload, it only reuses what is already in the library.

The grid lists up to 200 of your most recently uploaded images, newest first. Every image in the library belongs to your account and is scoped to it, so one account never sees another's assets.

How uploads are optimized

Every PNG, JPEG, and WebP upload is processed before it is stored so emails stay light. Pulse auto-orients the image from its EXIF data, strips remaining metadata, and downscales the longest edge to a maximum of 1200 pixels. Images smaller than that are never upscaled. The result is re-encoded in the same family it came from — PNG stays PNG, JPEG stays JPEG, WebP stays WebP.

GIFs are a special case: they pass through untouched so animation is preserved, and their dimensions are read from the file's metadata.

Deduplication

Assets are content-addressed: each stored image is keyed by a SHA-256 hash of its optimized bytes. If you upload an image whose processed bytes match one already in your account, Pulse reuses the existing stored object and library entry rather than creating a duplicate. Uploading the same file twice does not clutter your library.

When storage is not set up

Image storage relies on a configured asset bucket. If that backend is not connected, uploads fail with "Asset storage is not configured. Paste an image URL instead." In that case the editor still works — paste a link to an externally hosted image into the URL box and the email uses it directly.