How to add a lightbox effect in Magento product image switcher?

How to add a lightbox effect in Magento product image switcher?

July 22, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to add a lightbox effect in Magento product image switcher?

Adding a Lightbox Effect to Magento Product Image Switcher

Hi there! I hope this post finds you well. Recently, I came across an article from Inchoo that changes the default way Magento displays product images in the view. While their solution is easy to integrate, I wanted to take it a step further and add a lightbox effect.

Enhancing the Default Magento Image Switcher

By default, when you click on an image thumbnail in Magento, it switches with the main product image. However, I wanted to enhance this functionality so that clicking on the main image would open it in a lightbox for better user experience.

Integrating a Lightbox Effect

To achieve this effect, I used the Thickbox plugin within my custom theme’s media.phtml file:

<?php
    $_product = $this->getProduct();
    $_helper = $this->helper('catalog/output');
    $_gallery = $this->getGalleryImages();

    $_resize = 350;
?>

First, I included some necessary CSS styles and JavaScript code to handle the image switching and lightbox functionality:

<style type="text/css">
    .product-img-box .more-views li.slide-current a{ border:2px solid #aaa; }
    .product-img-box .product-image-zoom img { cursor: pointer; }
    #slide-loader{ visibility:hidden; position:absolute; top:auto; left:auto; right:2px; bottom:2px; width: 25px; height: 25px; }
</style>

Then, I added the JavaScript function slide(url,num,gallery) to handle the image switching and loading:

function slide(url,num,gallery){
    if (typeof slide.loading == 'undefined') slide.loading = false;
    if(slide.loading) return false;

    var loader = new Image();
    $(loader).observe('load', function(){

        $('slide-loader').setStyle({'visibility':'hidden'});

        // ... Rest of the code remains the same

Displaying the Main Product Image with Lightbox

In the media.phtml file, I wrapped the main product image in an <a> tag with the Thickbox class:

<?php
    $_img = '<a class="thickbox" href="'.$this->helper('catalog/image')->init($_product, 'image').'" title="'.$this->htmlEscape($this->getImageLabel()).'"><img id="image" src="'.$this->helper('catalog/image')->init($_product, 'image').'" alt="'.$this->htmlEscape($this->getImageLabel()).'" title="'.$this->htmlEscape($this->getImageLabel()).'" /></a>';
    echo $_helper->productAttribute($_product, $_img, 'image')
?>

When a user clicks on the main product image, it will open in a lightbox thanks to the Thickbox class.

Adding Thumbnail Navigation

I also included thumbnail navigation for additional images:

<?php if (count($_gallery) > 0): ?>
<div class="more-views">
    <h4><?php echo $this->__('More Views') ?></h4>
    <ul>
    <?php foreach ($_gallery as $_image): ?>
        <li>
            <a href="<?php echo $this->helper('catalog/image')->init($this->getProduct(), 'image', $_image->getFile()); ?>" onclick="slide('<?php echo $this->helper('catalog/image')->init($this->getProduct(), 'image', $_image->getFile()) ?>',<?php echo ($s = isset($s) ? ++$s : 0) ?>,'<?php echo $this->getGalleryUrl($_image) ?>'); return false;"><img src="<?php echo $this->helper('catalog/image')->init($this->getProduct(), 'thumbnail', $_image->getFile())->resize(65); ?>" alt="<?php echo $this->htmlEscape($_image->getLabel()) ?>" title="<?php echo $this->htmlEscape($_image->getLabel()) ?>" /></a>
        </li>
    <?php endforeach; ?>
    </ul>
</div>
<?php endif; ?>

Conclusion

In this post, I demonstrated how to enhance the default Magento product image switcher by adding a lightbox effect for better user experience. By using the Thickbox plugin and customizing the media.phtml file, we can display the main product image in a lightbox when clicked.

This solution provides an improved visual experience for customers while keeping the ease of use of the default Magento functionality intact.

Catalog Extensions Themes Orders

Our network