docs

Adding images

Upload, manage, and insert images into your emails.

There are several ways to get an image into an email — pick whichever fits your flow. Every image you add is hosted by Sendra automatically and stored in your media library.

Inserting images in the editor

HowWhat happens
Slash command — type /imageOpens a file picker; the uploaded image is inserted as a block
Toolbar → Insert imageOpens the media picker to upload a new image or reuse an existing one
Drag and dropDrop an image file straight onto the editor canvas
PastePaste an image from your clipboard directly into the editor

Reusing an existing image

When the media picker is open, search by filename and select any image you've uploaded before. This is the fastest way to reuse a logo or banner across campaigns without re-uploading.

Images outside the editor

  • Brand logo — upload it in Settings → Brand. It appears in email headers and the preference center via the {logoUrl} token.
  • HTML mode — when editing raw HTML, reference any image by URL in a standard <img src="…">. Copy a hosted URL from the media library with Copy URL, or point at an externally hosted image.
  • Reusable components — images saved inside a component come along whenever you insert it.

Supported formats and limits

FormatsJPEG, PNG, GIF, WebP, AVIF
Max file size5 MB per image

Images are hosted for you and served from a stable public URL — there's nothing to configure. Usage counts against your plan's storage quota; see Image storage & quotas.

Best practices

  • Optimize before uploading — compress images to keep email file sizes small. Large emails are more likely to be clipped by Gmail (which truncates emails over ~102 KB).
  • Use descriptive alt text — some email clients block images by default. Alt text ensures your message still makes sense.
  • Avoid text in images — screen readers can't read text baked into images, and it doesn't scale well on mobile.
  • Width matters — email content areas are typically 600px wide. Images wider than this are scaled down, which can cause blurriness. Upload at the intended display size, or 2× for retina.

On this page