Magento Configurable Image Switcher: Installation Guide & Manual

Table of Contents

• Overview
• Pre-Installation Requirements
• Installation Steps
• FAQ

Overview

The Configurable Image Switcher extension enhances the user experience on your Magento storefront by automatically updating the main product image when a customer selects a configurable product option.

When a customer chooses a specific variation (such as color or size) on the product page, the main display image dynamically switches to the image of the associated simple product.

Image Fallback Settings: If an associated simple product does not have an uploaded image, the extension can be configured via the admin panel to either:

• Display the default image placeholder.
• Retain the current main product image without changing.

Pre-Installation Requirements

Important: You must disable the Magento compiler before installing this extension to prevent system errors.

• Navigate to System > Tools > Compilation.
• Click the Disable button.

(Note: You can safely re-enable compilation once the installation is completely finished.)

Installation Steps

Follow these instructions to safely install the extension on your server.

Step 1: Disable Cache and Compilation

• Navigate to System > Cache Management and disable the cache.
• Navigate to System > Tools > Compilation and verify that compilation is disabled.

Step 2: Extract the Files

• Download the extension's .zip archive.
• Extract the files from the archive into a temporary folder on your local computer.

Step 3: Upload Files to the Magento Root

• Connect to your server.
• Copy the files from the extracted Step 1 folder and paste them into your Magento root directory.
• Next, copy the files from the Step 2 folder and paste them into your Magento root directory.

Step 4: Refresh the Admin Session and Indexes

• If you are currently logged into the Magento Admin panel, log out and log back in to refresh your session permissions.
• Navigate to System > Index Management and refresh all indexes.