Images Not Loading

If images appear broken (as grey boxes or missing icons) on your storefront, work through these checks in order.

1. Check the image was saved

In the Page Builder or Product editor, confirm the image is still attached after saving. Open the page or product and look for the image in the media panel. If the slot is empty, re-upload the image and save again.

2. Confirm the upload completed

Large images can time out during upload if your internet connection is slow. Signs of a failed upload:

• The upload progress bar stopped before reaching 100%.
• The image shows as a grey placeholder in the editor.
• Saving the page produced an error toast.

To fix: refresh the page, re-open the image picker, and upload the image again. Try compressing the image to under 5 MB if uploads consistently fail.

3. Check file format

Sellrn supports these image formats:

• JPEG / JPG
• PNG (with transparency)
• WebP
• GIF (static only — animated GIFs are not supported)
• SVG (for logos and icons only)

HEIC/HEIF files (common on iPhones) are not supported. Convert them to JPEG or WebP before uploading (use Preview on Mac, or any online converter).

4. Check maximum file size

The maximum image upload size is 10 MB per file. Images above this limit are silently rejected. Use an image optimiser (e.g. Squoosh, TinyPNG) to compress large photos before uploading.

5. Hard refresh the storefront

Your browser may have cached a broken image URL. Try a hard refresh:

• Mac: Cmd + Shift + R
• Windows / Linux: Ctrl + Shift + R

6. Check in a different browser or device

If the image loads in one browser but not another, the issue is likely a browser extension (e.g. an aggressive ad blocker blocking the CDN domain). Try in an incognito window with extensions disabled.

7. Storefront CDN propagation

Images are served via Supabase Storage CDN. Newly uploaded images can take up to 60 seconds to propagate to all CDN nodes. If an image was just uploaded, wait a minute and refresh the storefront.

Still broken?

Open your browser's developer tools (F12) → Network tab → filter by "Img" → reload the page. Find the broken image request and check the status code:

• 403 Forbidden — the image storage bucket is not public. Contact Sellrn support to restore the bucket policy.
• 404 Not Found — the image was deleted from storage. Re-upload it.
• Mixed content warning — your custom domain may not have SSL fully configured. Check domain settings.