Add-On Image Mapper for WooCommerce allows you to dynamically switch the main product image based on customer selections in WooCommerce Product Add-Ons.
Perfect for:
- Clothing stores (color, size previews)
- Custom furniture (fabric, finish)
- Print-on-demand setups
- Any product where visual options improve buying confidence
Installation
↑ Back to top- Download Add-On Image Mapper for WooCommerce .zip file from your WooCommerce account.
- At the Admin Panel, go to Plugins > Add New and Upload extension with the file you downloaded after purchase.
- Install and Activate the extension.
More information at: Install and Activate Plugins/Extensions.
How to Configure Add-On Image Mapper for WooCommerce?
↑ Back to topGetting started
↑ Back to topStep 1: Enable the Extension
Step 1: Create Product Add-Ons
↑ Back to top
Before you map images to add-on options, you first need to create product add-ons using the WooCommerce Product Add-Ons extension.
- Go to the Product Edit screen for the product you want to configure.
- In the Product Add-Ons section, create options such as Color, Size, Material, etc.
- Add the individual option values (e.g., Red, Blue for Color; Small, Large for Size).
- Save or update the product.
Step 2: Configure Add-On Image Mapper
↑ Back to top
After the add-ons are created and saved:
- Scroll up to the Add-On Image Mapper for WooCommerce meta box (as shown in the screenshot).
- You will see rows representing combinations of add-on values (e.g., Red + Large, Blue + Small).
- For each combination, select the corresponding image that visually represents the option selection.
- Click “Select Image” to choose or upload an image from the media library.
- To add more combinations, click “+ Add New Row”.
- For each row, you can add multiple product options by clicking “+ Add Product Option”.
- Remove any row or option by clicking the “×” icon.
- Once finished, click Update or Publish the product.
Front-End Overview of Add-On Image Mapper
↑ Back to topWhen a customer visits your WooCommerce product page, the Add-On Image Mapper enhances their shopping experience by dynamically updating the main product image based on the options they select from the WooCommerce Product Add-Ons.
Key Front-End Features:
↑ Back to topMobile-Friendly and Responsive:
Works perfectly on all devices, whether desktop, tablet, or mobile, ensuring consistent visual feedback.
Real-time Image Switching:
As customers select product options (e.g., color, size, material), the main product image updates immediately to reflect their choice, providing an accurate visual preview.
Supports Multiple Add-On Combinations:
Images can be mapped to single options or combinations of options, ensuring customers see the exact product variant they are customizing.
Seamless User Experience:
The image update happens smoothly without page reloads, maintaining the natural flow of product browsing and selection.
How it Works on the Front-End
↑ Back to top- Initial Product Image:
When the product page loads, the default product image is shown. - Option Selection:
Customers choose from the available add-on options, such as color or size, through dropdowns, radio buttons, or other add-on fields. - Image Mapping Triggered:
Once an option or combination of options is selected, the extension looks for a mapped image associated with that choice. - Main Image Update:
The main product image changes instantly to the mapped image for that option, giving the customer a live preview. - Cart Integration:
The selected image ID is saved with the cart item, so the customized product’s image remains consistent through checkout and order confirmation.
Displaying Selected Images on the Thank You and Order Pages
↑ Back to topYour customers will not only see dynamic product images on the product page but also throughout the entire shopping experience, including the Thank You (Order Confirmation) page and the Order Details page in their account. This reinforces their purchase decision and reduces confusion.

Backend Order View
↑ Back to top
Benefits to Your Customers
↑ Back to top- Clearer Visualization: Customers see exactly what they will receive based on their choices.
- Reduced Returns: Less confusion or miscommunication about product variations.
- Increased Engagement: Interactive, dynamic pages encourage more confident buying decisions.
- Professional Presentation: Enhances your store’s image with modern, user-friendly product pages
FAQs
↑ Back to top
Does this extension work with the official WooCommerce Product Add-Ons extension?
↑ Back to top
Does this extension work with the official WooCommerce Product Add-Ons extension?
↑ Back to topYes, the Add-On Image Mapper is specifically built to integrate seamlessly with the official WooCommerce Product Add-Ons extension.
Can I assign multiple images to a single add-on option?
↑ Back to top
Can I assign multiple images to a single add-on option?
↑ Back to topCurrently, each add-on option maps to a single image. Support for multiple images or image galleries per option may be added in future releases.
Will this extension work with variable products?
↑ Back to top
Will this extension work with variable products?
↑ Back to topThe extension primarily targets simple products with add-ons. Variable products are supported but image switching is focused on the selected add-on options rather than variations.