Documentation Index

For the complete documentation index, see llms.txt. Markdown versions of docs pages are available through the page's alternate Markdown link.

Current page: Hosting your exported email images - You have the option to self-host your exported image files, or have Emailify automatically upload them for you to our own CDN.. Machine-readable page: /emailify/export/images.md.

Hosting your exported email images

You have the option to self-host your exported image files, or have Emailify automatically upload them for you to our own CDN.

Using the Emailify image hosting CDN (default) ​

For HTML exports, by default, Emailify will export your HTML emails with any images saved alongside the .html files, so you can upload them wherever you like.

However, if you want to use the Emailify CDN (content delivery network) to host your images for you, you can enable the Upload Hosted Image URLs toggle. This will upload your images and automatically swap out the URLs in your HTML email to point to the uploaded files.

If you're using any of the built-in email marketing platform integrations, your images will automatically be uploaded to the Emailify CDN.

Uploading image assets to your own self-hosted Cloud Storage bucket ​

By default, Emailify will use the Emailify CDN (content delivery network) to host your images for you, but you can optionally swap this out to use your own cloud storage service bucket (for example, AWS S3 or Backblaze B2 instead.

Once you select the image hosting service you'd like to use, you need to enter your bucket credentials and details below, which will automatically upload your image assets to your own bucket (and use your bucket image path in the src attributes of your HTML <img> tags) during the export process:

  • Region (for example, us-east-1)
  • Access Key (for example, 003g8...)
  • Secret Access Key (for example, K454q...)
  • Bucket Name (for example, my-emailify-bucket)
  • Bucket URL (for example, https://my-emailify-bucket.s3.us-east-1.amazonaws.com/)

Please ensure any buckets you create are set to Public access view permissions, otherwise the uploaded image URLs won't be accessible when the HTML email is sent out

If you're using Cloudflare R2, paste your R2 S3 endpoint into the URL field using the format https://accountid.r2.cloudflarestorage.com/ rather than https://your-bucket.r2.cloudflarestorage.com/. Emailify will combine that endpoint with your bucket name automatically when it creates the signed upload URLs.

Supported self-hosted cloud storage service options in Emailify ​

You can self-host the exported images from Emailify in any of the S3-compatible object storage services below:

Setting a custom base URL to self-host the exported email images on your own server or CDN ​

By default, the src for all the images in your HTML exported by Emailify will be a relative img/ path (for example, img/ceb3f891b78815897e04299f93eef255.jpg); this lets you Review your email and upload a zip to certain platforms like MailChimp, which will automatically upload the images and update the src URLs for you.

However, if you're using a platform that doesn't support this feature or are just hosting the images on your own custom server, you may want to set your own custom base URL instead.

Per-Email Custom Base URL ​

You can set a custom base URL for individual emails by selecting your main email Figma frame, clicking the Settings button in the plugin header, then enabling the Override "img/" Base Path toggle and pasting in your own base URL path where the images are going to be hosted; enabling the custom base URL will automatically prefix all of the image src attributes for your images (for example, replacing img/ with https://your-custom-server.com/image/path/here/ in the exported HTML file).

This per-email setting is ideal when you need different base URLs for specific campaigns or want to override the global CDN setting for individual emails.

Global Custom CDN Base URL ​

If you're consistently hosting images on the same custom CDN or server across all your emails, you can set a global custom base URL instead of configuring it for each email individually:

  1. In the export settings panel, locate the CDN dropdown menu
  2. Select Custom Base URL from the list of CDN options
  3. Enter your custom base URL in the input field that appears (e.g., https://cdn.example.com/images/)
  4. All exported emails will now use this base URL for image paths by default

The global custom CDN setting provides a convenient way to standardize image hosting across your email campaigns. If both global and per-email custom base URLs are configured, the per-email setting takes priority, giving you flexibility to override the global CDN when needed for specific campaigns.

Whether using global or per-email settings, ensure your custom base URL is publicly accessible and properly configured with CORS settings if required. The URL can include or omit a trailing slash, Emailify will handle both formats correctly.

Why are images not rendering in my exported HTML email? ​

Email images usually fail to render after sending when the image files are not hosted at public online URLs, the email was sent from a tool that rewrote the HTML, or the recipient email client blocked remote images.

If you export HTML with local img/ paths, the images are saved next to the .html file and must be uploaded with the email template or hosted separately. If you enable Upload Hosted Image URLs, Emailify uploads the images and swaps the HTML image URLs to hosted links automatically.

Why do images work locally but not after sending? ​

A local HTML preview can load images from the exported img/ folder on your computer. Once the email is sent, recipients cannot access files on your computer, so the images need to be hosted online or uploaded through your ESP.

Gmail and Outlook are not reliable ways to send exported custom HTML because they can change the markup and do not handle image hosting for a bulk HTML email workflow. Use an ESP or one of Emailify's built-in integrations instead.

What should I check first if exported images are broken? ​

  • Make sure the images are hosted at public https:// URLs, or upload the exported img/ folder through your ESP.
  • Enable Upload Hosted Image URLs if you want Emailify to upload image assets for you.
  • If using a custom bucket or CDN, make sure the bucket allows public read access for the uploaded image URLs.
  • If an upload fails, check whether a VPN, firewall, proxy, or company network is blocking the upload request.
  • Wait for Figma images to finish loading in the file before exporting.
  • Remember that some email clients block remote images until the recipient chooses to display them.