WPC Product Image Swap 1.2.5 – for WooCommerce

I installed WPC Product Image Swap on a WooCommerce store where the theme’s product cards were, frankly, a crime scene. The client wanted the classic “hover over product, show second image” thing. Simple request, right? Of course not. The theme had its own lazy-load wrapper, Elementor had injected three extra divs, and WooCommerce gallery thumbnails were being treated like decorative confetti.

WPC Product Image Swap did the annoying part cleanly: it grabs another product gallery image and swaps it on hover in the shop loop. No giant builder module, no React circus, no “please connect your account to unlock basic CSS” nonsense.

Where I Actually Configured It

After activation, I had the settings under:

Dashboard -> WPClever -> Product Image Swap

On my setup, the useful bits were the swap effect, image source behavior, and whether it applies on archive/shop loops. For a basic catalog grid, that’s enough.

What you can handle from the admin panel:

• Enable/disable the swap behavior
• Pick the hover effect
• Control where it applies, like shop/category pages
• Adjust basic behavior without touching templates

What you cannot magically fix there:

• Broken theme markup in woocommerce/content-product.php
• Weird image wrappers hardcoded in archive-product.php
• Custom product cards built inside Elementor widgets
• Themes replacing WooCommerce hooks like woocommerce_before_shop_loop_item_title

And yes, I absolutely hate when themes remove WooCommerce hooks “for performance” and then load a 900 KB slider script on every page. What were they thinking?

DevTools Reality Check

I opened Chrome DevTools, went straight to the Network tab, and checked what WPC Product Image Swap was adding. On my test build, the damage was modest compared with the theme loading five font weights, two carousel libraries, and a random animate.css file from 2016.

The thing I actually watched for was duplicate image loading. If your product grid has 24 items and every item pulls the main image plus the swap image, congratulations, your category page just got heavier. Not the plugin’s fault, mostly. That’s literally how image swap works.

In the Console, I didn’t get the usual jQuery vomit. The only breakage happened after the optimization plugin got “creative” and delayed everything with $ in it.

The Typical Breakage I Hit

On one site, LiteSpeed Cache delayed jQuery and merged frontend scripts. Result: WPC Product Image Swap worked for the first row, then randomly stopped after AJAX filtering.

My ugly-but-working fix:

LiteSpeed Cache -> Page Optimization -> JS Settings

I excluded:

• jquery-core
• jquery-migrate
• wc-add-to-cart
• wc-add-to-cart-variation
• the product filter plugin’s frontend handle
• the WPC swap frontend script handle as shown in the page source

Then I purged object cache, CSS/JS cache, and CDN cache. Yes, all three. Because apparently one cache layer is never enough pain.

If you’re using WP Rocket, I’d start at:

WP Rocket -> File Optimization -> Delay JavaScript execution

and exclude jQuery plus the WPC frontend script. Don’t guess the handle; open page source or Query Monitor and check the actual enqueued file.

Builder vs PHP: Know Where the Mess Lives

If your shop grid is standard WooCommerce, WPC Product Image Swap behaves nicely. If your theme uses templates properly, check:

wp-content/themes/your-theme/woocommerce/content-product.php

Look for:

do_action( 'woocommerce_before_shop_loop_item_title' );

If that hook is missing, don’t blame the plugin. The theme basically cut the wire and then acted surprised the lamp won’t turn on.

For Elementor product grids, it depends. Native WooCommerce archive templates are usually fine. Custom Elementor Loop Grid widgets can be stubborn because the image markup is generated inside Elementor’s widget output, not the normal WooCommerce template chain.

My hack once was to copy content-product.php into the child theme and restore the missing WooCommerce image hook. Not elegant. But neither was the theme.

GPL and Updates

I tested WPC Product Image Swap as a normal WordPress plugin install. It was fully working in my setup, no weird usage cap, and the build I used allowed Unlimited Website Usage.

Activation was boring, which I appreciate. Install ZIP via:

Plugins -> Add New -> Upload Plugin

Activate it, then go to the WPClever settings page. If you’re using a GPL package, don’t expect the dashboard to behave like a licensed vendor account. Manual updates usually mean downloading the newer ZIP, deleting the old plugin folder, and uploading the new one. I usually do that on staging first because I enjoy sleeping.

Demo import is not really the point here. This is not a theme with demo content. It just hooks into existing WooCommerce product images, so your “demo” is basically having products with gallery images filled in.

My Verdict After the Debugging Hangover

WPC Product Image Swap is one of those small WooCommerce plugins that does one job and mostly stays out of the way. I respect that. It won’t save a butchered theme, and it won’t make your 80-product archive magically lightweight, but it gives you the hover swap behavior without dragging in a whole visual builder.

Would I use WPC Product Image Swap again? Yes, especially on stores where product gallery images are already prepared properly. Would I install it on a bloated theme with broken WooCommerce hooks? Also yes, but I’d bill for debugging.

FAQ

Why does the image swap not work on my custom product grid?

Because your builder probably bypasses woocommerce_before_shop_loop_item_title. Check the rendered HTML and compare it with content-product.php.

Why does it break after enabling JS optimization?

Your cache plugin delayed or merged the frontend script. Exclude jQuery and the WPC swap script in LiteSpeed Cache or WP Rocket.

Can I fix the hover effect from the Customizer?

Usually no. Basic plugin behavior is in Dashboard -> WPClever -> Product Image Swap. Deeper markup issues live in PHP templates.

Why are category pages heavier now?

Because every product may load an extra gallery image for hover. Check DevTools Network tab and reduce products per page if needed.