Title: WPThemePrime Product Image Swap for WooCommerce
Author: wpthemeprime
Published: <strong>May 31, 2026</strong>
Last modified: May 31, 2026

---

Search plugins

![](https://ps.w.org/wpthemeprime-product-image-swap/assets/banner-772x250.png?rev
=3556846)

![](https://ps.w.org/wpthemeprime-product-image-swap/assets/icon-256x256.png?rev
=3555810)

# WPThemePrime Product Image Swap for WooCommerce

 By [wpthemeprime](https://profiles.wordpress.org/wpthemeprime/)

[Download](https://downloads.wordpress.org/plugin/wpthemeprime-product-image-swap.1.2.0.zip)

 * [Details](https://wordpress.org/plugins/wpthemeprime-product-image-swap/#description)
 * [Reviews](https://wordpress.org/plugins/wpthemeprime-product-image-swap/#reviews)
 *  [Installation](https://wordpress.org/plugins/wpthemeprime-product-image-swap/#installation)
 * [Development](https://wordpress.org/plugins/wpthemeprime-product-image-swap/#developers)

 [Support](https://wordpress.org/support/plugin/wpthemeprime-product-image-swap/)

## Description

**WPThemePrime Product Image Swap for WooCommerce** lets customers preview a second
product image by hovering over any product card — in shop pages, categories, or 
home page grids.

**Key Features:**

 * **8 Animation Types:** Fade, Slide Up/Down/Left/Right, Zoom In/Out, and Instant
   Swap.
 * **Auto Gallery Fallback:** No secondary image set? The plugin automatically uses
   the first WooCommerce gallery image. Works immediately for stores that already
   have gallery images — zero setup per product.
 * **Mobile Tap Support:** On touch devices, tap once to reveal the secondary image;
   tap again to navigate to the product.
 * **Image Preloading:** Secondary images are preloaded on hover-intent to prevent
   flash or delay.
 * **Live Settings Preview:** See your animation in real time on the settings page—
   with a Play button to simulate the effect.
 * **Custom Speed:** Set animation duration from 50ms to 5000ms using a range slider.
 * **Page Control:** Enable or disable independently for Shop, Home, and Single 
   product pages.
 * **HPOS Compatible:** Fully compatible with WooCommerce High Performance Order
   Storage.
 * **Clean Uninstall:** All plugin data is removed from the database when the plugin
   is deleted.

**How to Use:**

 1. Go to **Products > Edit Product**.
 2. Find the **Secondary Product Image (Swap)** box in the right sidebar.
 3. Click **Select / Upload Image**.
 4. Save the product.
 5. Configure animation and display options at **WooCommerce > Image Swap**.

## Screenshots

[⌊Settings Page: Configure animation type and speed with live preview.⌉⌊Settings
Page: Configure animation type and speed with live preview.⌉[

**Settings Page:** Configure animation type and speed with live preview.

[⌊Product Editor: Upload the secondary image from the sidebar meta box.⌉⌊Product
Editor: Upload the secondary image from the sidebar meta box.⌉[

**Product Editor:** Upload the secondary image from the sidebar meta box.

## Installation

 1. Upload the `product-image-swap-for-woocommerce` folder to `/wp-content/plugins/`.
 2. Activate through the **Plugins** menu in WordPress.
 3. Configure at **WooCommerce > Image Swap**.

## FAQ

### Does this work with all WooCommerce themes?

Yes, with most WooCommerce-compatible themes that use standard WooCommerce templates.
Themes heavily overriding WooCommerce templates may need minor CSS adjustments.

### Will it slow down my store?

No. All transitions are CSS-based. Secondary image IDs are cached via WordPress 
object cache to prevent extra database queries on pages with many products.

### Does this work on mobile?

Yes. The first tap on a product image reveals the secondary image. The second tap
navigates to the product page. Tapping outside any product resets all.

### Does this work with WooCommerce Blocks?

This plugin supports classic WooCommerce templates (shortcodes, PHP-based themes).
WooCommerce Blocks (Gutenberg/FSE product loops) are not currently supported — this
is a known limitation.

### What is the Auto Gallery Fallback?

When enabled, if a product has no manually assigned secondary image, the plugin 
uses the first image from the WooCommerce product gallery automatically. Stores 
with existing gallery images work with zero per-product setup.

### What happens to my data when I delete the plugin?

All plugin data is removed: the settings option and all secondary image assignments
are deleted from the database.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“WPThemePrime Product Image Swap for WooCommerce” is open source software. The following
people have contributed to this plugin.

Contributors

 *   [ wpthemeprime ](https://profiles.wordpress.org/wpthemeprime/)

[Translate “WPThemePrime Product Image Swap for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/wpthemeprime-product-image-swap)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wpthemeprime-product-image-swap/),
check out the [SVN repository](https://plugins.svn.wordpress.org/wpthemeprime-product-image-swap/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wpthemeprime-product-image-swap/)
by [RSS](https://plugins.trac.wordpress.org/log/wpthemeprime-product-image-swap/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.2.0

 * Added: Auto gallery fallback.
 * Added: Mobile tap-to-reveal.
 * Added: Image preloading on hover.
 * Added: Live animation preview on settings page with Play button.
 * Added: Animation speed range slider.
 * Added: Zoom Out, Slide Left, Slide Right animation types.
 * Added: HPOS compatibility declaration.
 * Added: Object cache for secondary image ID lookups.
 * Added: WooCommerce activation check with admin notice.
 * Fixed: border-radius not applied to secondary images.
 * Fixed: Secondary images affected by lazy-load themes.
 * Improved: Full prefix refactor to pisw_ — no collision with common terms.
 * Improved: Security — all output escaped, all input sanitized.

#### 1.0.0

 * Initial release.

## Meta

 *  Version **1.2.0**
 *  Last updated **2 months ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **7.0.2**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [image hover](https://wordpress.org/plugins/tags/image-hover/)[image swap](https://wordpress.org/plugins/tags/image-swap/)
   [product image](https://wordpress.org/plugins/tags/product-image/)[woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/wpthemeprime-product-image-swap/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/wpthemeprime-product-image-swap/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wpthemeprime-product-image-swap/reviews/)

## Contributors

 *   [ wpthemeprime ](https://profiles.wordpress.org/wpthemeprime/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/wpthemeprime-product-image-swap/)