Articles on: Magento 2 User Guide

How to import Listing Hover Images

During the default Magento Product Import process, or when updating product images, you may want to add Listing Hover Images. This feature is specific to the Pearl Theme. Follow the steps below to configure them correctly.



Step 1. Upload Images to Server


Upload the images you want to use as Listing Hover Images to your server in a specific folder.

Example: var/import



Step 2. Export Products


  1. In the Magento Admin, go to System -> Data Transfer -> Export.
  2. From the Entity Type dropdown, select Products.
  3. Click Continue at the bottom of the page.



Step 3. Edit the CSV File


  1. Open the generated CSV file.
  2. Locate the product(s) you want to add Listing Hover Images for.
  3. In the additional_attribute column, add the following:


   weltpixel_hover_image=/your_listing_hover_image.jpg


Example:


weltpixel_hover_image=/rose-blue-flower-rose-blooms.jpg


magento2-listing-hover-image-csv.png


  1. Save the CSV file after editing.



Step 4. Import the Updated CSV


  1. In the Magento Admin, go to System -> Data Transfer -> Import.
  2. From the Entity Type dropdown, select Products.
  3. From the Import Behavior dropdown, select Add/Update (or another option, depending on your needs).
  4. Upload your updated CSV file via the Select File to Import option.
  5. Specify the Images File Directory as the folder path where you uploaded the images (e.g., var/import).


After the import is complete, verify the images under:


Catalog -> Products -> [Select Product] -> Images and Videos Tab


magento2-listing-hover-image-admin.png



✅ Done! Your Listing Hover Images should now be visible on the frontend.

Updated on: 18/09/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!