> ## Documentation Index
> Fetch the complete documentation index at: https://cloudinary.com/documentation/llms.txt
> Use this file to discover all available pages before exploring further.

# Product Gallery changelog



This changelog covers the new features, enhancements, and fixes of each major and minor Product Gallery release.

> **See also:**:
>
> * [Product Gallery Guide](product_gallery)

> * [Product Gallery Reference](product_gallery_reference)

## v1.3

### v1.3.3
Oct-27-2025

* **Enhancement**: Allow 3D model auto-rotation using `autoRotate: true`.
* **Enhancement**: Add zoom buttons to the 3D viewer using `showZoomButtons: true`.
* **Enhancement**: Use accumulative shadow by default in the 3D viewer.
* **Enhancement**: Add 3D model loaded event: `3dmodelloaded`.
* **Enhancement**: Add AR button click event: `onArClick`.
* **Enhancement**: Add AR QR code ready event: `onQrReady`.
* **Enhancement**: Make the active image focusable.
* **Fix**: No longer throw an error when unable to create a placeholder for an asset.

## v1.2

### v1.2.11
Oct-23-2025

* **Enhancement**: Zoom popup asset heights are now rounded to the nearest breakpoint (default: 100px) to reduce the number of required asset transformations.
* **Fix**: Zoom popup +/- buttons now respond to Enter and Space keys when focused, improving keyboard accessibility.
* **Fix:** On iOS, the native video player now correctly displays the video poster as configured, matching the behavior of the Cloudinary Video Player.
* **Fix:** Asset versions are now respected when retrieving assets by tag; the widget displays the correct version returned from the asset list.

### v1.2.9
Mar-9-2025

* **Enhancement** Improve scroll/swipe touch-handling behaviors in mobile.
* **Fix**: Fixed an issue where transformations provided via configuration object weren't passed through to the zoom popup.

### v1.2.8
Jan-27-2025

* **Enhancement**:  Swipe/scroll touch gestures handling improved in iOS Safari on iPhones.

### v1.2.5
Jan-16-2025

* **Enhancement**:  Touch gestures were enhance to prevent vertical page-scroll when horizontally swiping the gallery.

### v1.2.3
Jan-08-2025

* **New feature**: Added 5 new [methods](product_gallery_reference#instance_methods) to allow programmatically setting the current asset in the display or for getting info about the currently displayed asset:
    * `setItem(index)`
    * `nextItem()`
    * `prevItem()`
    * `getActiveItem()`
    * `getActiveIndex()`

### v1.2.2 
Dec-03-2024

* **New feature**: Pinch to zoom to allow multi-zoom on mobile. Previously, multi-zoom was available only for desktop using +/- buttons. Now end users can also use multi-zoom on touch devices by pinching.
* **Enhancement**: Improved gesture handling logic. Swipe and other zoom and carousel-transitions are more performant and much smoother.
* **Fix**: Prevent double loading of assets. When configuring a gallery with a zoom popup and not preloading assets, the assets that are behind an open popup won't render. This is a huge improvement for galleries with zoom-popup and many hard-to-render assets, like videos and 3D models.

## v1.1

### v1.1.36 
Nov-04-2024

* **New feature**: Endless looping carousel. Allows you to configure the previous/next buttons to always be available, so that when a user reaches the start/end of the carousel it jumps back to the first/last item. Enable looping by setting `carouselLoop: 'jump'`  ([example](https://product-gallery.cloudinary.com/1.1.36/carousel.html?ver=1.1.36))
* **New feature**: Popup initial zoom. Allows users to request that the zoom popup opens already zoomed in. Enable initial zoom by configuring `zoomPopupProps: { initialZoom: true }`  ([example](https://product-gallery.cloudinary.com/1.1.36/multi-zoom.html?ver=1.1.36))
* **Fix**: Improved swipe handling for iOS devices.
* **Maintenance**: Updated many dependencies.

### v1.1.28 
Oct-27-2024

* **New feature**: To improve performance, you can now control an asset's `fetchPriority` property, which tells the browser the order to fetch assets, either earlier (`high`) or later (`low`). By default, `fetchPriority` is automatically set to `high` on the first image in a gallery.
* **Enhancement**: Improved render flow - optimized image loading:

    * If a thumbnail image is available, the Product Gallery also uses that image as the placeholder image, making only a single request for an image, instead of 2 requests.
    * The Product Gallery now loads the zoom image on-demand only when needed, postponing the request of the bigger zoom image.
    * **Results** of testing a minimal gallery with a single asset:
        * Before - requests 4 images at 159kb. [Example](https://cloudinary-res.cloudinary.com/image/upload/v1737648113/docs/pgw_before.png)
        * After -  requests 2 images at 53kb. [Example](https://cloudinary-res.cloudinary.com/image/upload/v1737648313/pgw_after.png)

### v1.1.26 
Oct-13-2024

* **Enhancement**: Major refactor to the carousel component, swipe/scroll logic, and state management, for improved performance and user experience, and prevents a noticeable delay in the active-index indicator interface ([before](https://player.cloudinary.com/embed/?public_id=Screen_Recording_2024-10-02_at_12.17.53_zfmnwf&cloud_name=demo)/[after](https://player.cloudinary.com/embed/?public_id=Screen_Recording_2024-10-02_at_12.18.33_rzalum&cloud_name=demo)).
* **Fix**: Addressed reported issues with inline zoom when using a mouse on touch-enabled laptops.

## Register for notifications

Make sure you always know when we publish new a changelog with the **Product Gallery Changelog RSS feed**: 

 Grab this [RSS link](/documentation/rss/cloudinary-pgw-release-notes.xml) to watch for updates to the Product Gallery changelog in your favorite RSS reader.