Migrating from Cloudinary 3D to the Product Gallery widget viewer
Last updated: Oct-29-2025
Important
Cloudinary 3D viewer and AR capabilities are transitioning to the Product Gallery Widget. Cloudinary 3D remains available through Q1 2026 to support your move.Introduction
This page explains how to migrate from the Cloudinary 3D viewer to the Product Gallery widget viewer.
In addition, see the Product Gallery API reference and guide to become familiar with its capabilities.
On this page:
Typical configuration
This is a typical Product Gallery widget configuration:
Note
The 3D model file identifier is now its Cloudinary public ID, not Cloudinary 3D's SKU, as shown in the example above under the mediaAssets property.Viewer events
Tip
Learn about Product Gallery widget events.The events relevant to the 3D viewer experience are:
- 3dmodelloaded: Fired once the model has finished loading.
- onQrReady: Fired once the QR code and URL for the AR viewer are ready. The payload includes the QR SVG and the URL string.
- onArClick: Fired when the user clicks the native view in AR button.
Customization examples
Custom AR modal
Use a custom AR modal to display the QR code but keep the native "view in AR" button:
HTML template:
Custom AR button and AR modal
Use a custom "view in AR" button and a custom AR modal to display the QR code:
HTML template:
✖️
Error
Rate this page:
