change Magento to new server, images of existing product do not shown in frontend

change Magento to new server, images of existing product do not shown in frontend

August 7, 2026 · Illustrated author avatarBy Stefan Bogdanescu
change Magento to new server, images of existing product do not shown in frontend

Moving Magento to a New Server: Solving Image Display Issues

Moving your Magento site to a new server can significantly improve performance, but it often leads to image display issues in the frontend. In this post, we’ll troubleshoot the common problem of images appearing as placeholders after migrating your store.

Understanding the Image Cache Issue

Magento uses an image cache system to optimize product images for browsing. When you move your site, the cache folder (media/catalog/product) is often empty or missing, leaving only placeholder images in its place. Here’s why:

  1. The cache folder doesn’t get migrated automatically.
  2. Magento always looks for images in the cache folder first.
  3. If it can’t find them there, it falls back to using the default placeholder image.

5 Steps to Resolve Image Display Issues

Step 1: Manually Copy the Cache Folder

The most straightforward solution is to manually copy the media/catalog/product folder from your old server to the new one. This should contain all the cached images for your products.

scp -r /path/to/old/media/catalog/product user@new_server:/var/www/html/public/media/catalog/product

Step 2: Enable Permissions for Media Folder

Ensure that the media folder has proper permissions to read and write. You can use the following command:

chmod -R 755 media

Step 3: Flush Image Cache and Reindex

While these steps aren’t enough on their own, they’re important for ensuring Magento is looking at the correct data.

  • Go to System > Cache Management in your admin panel.
  • Select all cache types under ‘Actions’ and choose “Flush All”.
  • Navigate to System > Index Management.
  • Choose “Reindex All” or only the necessary indexes (e.g., catalog_product_attribute, catalog_product_price).

Step 4: Delete htaccess Files

Sometimes, an .htaccess file in the media/catalog/product folder can prevent images from being displayed. Try deleting these files if they exist.

rm media/catalog/product/.htaccess

Step 5: Check Image URLs and Paths

Ensure that your image URLs are correct after migration. Magento uses relative paths by default, so you shouldn’t need to update them manually unless you’ve changed the base directory structure.

A Final Note on Migration Best Practices

To avoid these issues in the future:

  1. Always backup your media folder before migrating.
  2. Consider using a version control system (like Git) to manage your Magento files and keep track of changes.
  3. Use deployment tools like Capistrano or Ansible for automated, hassle-free deployments.

Remember that migrating a Magento site is a complex task that requires careful planning and testing. Don’t hesitate to reach out to professionals if you’re unsure about any part of the process.

Happy migrating! For more tips on Magento performance optimization and server management, check out our Magento Optimization Guide at LaravelCompany.

Conclusion

Resolving image display issues after a Magento migration requires a systematic approach. By copying the cache folder, adjusting permissions, flushing caches, and checking URLs, you can quickly restore your images to their glory.

Remember that Magento’s caching system is powerful but also complex—understanding how it works is key to maintaining a fast, secure site long-term.

Catalog Cache Indexing Performance

Our network