# Migrating Ecommerce Images and Media

> Use controlled steps to complete migrating ecommerce images and media, validate the result and resolve exceptions before launch.

- Type: Merchant guide
- Level: Intermediate
- Reading time: About 4 minutes
- Audience: Written for store owners, builders, and designers refining high-performance ecommerce stores.
- Last updated: 2026-11-04
- Canonical page: https://academy.getzenbasket.com/merchant-questions/migrating-ecommerce-images-and-media/
- Part of: [Merchant Questions](https://academy.getzenbasket.com/merchant-questions/) on ZenBasket Academy

---

## What you need to know

### How should product images be migrated?

Create an asset manifest that links each product and variant to its image files, roles, order and alt text. Transfer originals or approved derivatives, then verify file responses and rendered pages.

### How should image URLs be handled?

Prefer durable destination URLs and update product records to point directly to them. If old image URLs have meaningful external use, retain or redirect them according to the media delivery design.

### Should images be optimized during migration?

Optimize images when the change has defined quality and performance targets, and original files are retained. Avoid mixing uncontrolled compression or format changes into migration without visual comparison.

### How should product videos be migrated?

Confirm ownership and provider portability, then migrate video files or approved embeds with product relationships, captions, poster images and display order intact. Test playback across supported devices.

### How do I detect missing images after migration?

Compare the asset manifest with destination responses and product-media relationships, then crawl rendered pages for broken or empty media. Prioritize products with sales, ads, or high search traffic.

### How should image alt text be preserved?

Map alt text as its own product-media field instead of deriving it from filenames. Sample the rendered image markup to confirm the correct text remains attached to the correct image.

### A quick store check

Choose one media-heavy product and compare every destination file, relationship, position and accessibility field with the manifest.

---

## Frequently asked questions

### Should original media files be retained?

Yes, when rights and storage policy allow it. Originals provide a safe source if new transformations fail.

### Does a successful file upload prove the image works?

No. Verify the response, product relationship, and rendered output on supported devices.

## Related articles

- **Migrating Categories Collections and Taxonomy**
- **Ecommerce Customer Data Migration**