On this page
1.3.4 - 26 October 2026
Added
NoCameraError, CameraInUseError and ARNotSupportedError error types, thrown by launchAR when the device has no camera, the camera is used by another application, or the browser can't run AR (no WebGL2 or WebAssembly). All extend LaunchARError.AR error messages for each failure, customizable with strings: error.ar.cameraDenied, error.ar.noCamera, error.ar.cameraInUse, error.ar.arNotSupported and error.ar.failed.
AR launch time breakdown in arLaunchSuccess and arLaunchFailure analytics events. See Analytics .
Changed
AR failures other than denied camera permission now show a matching message instead of the camera permission message. cameraErrorText only replaces the camera permission message.
Longer error stack traces in analytics (up to 4000 characters).
Updated DeepAR to 5.7.1.
Fixed
AR in browsers without WebGL2 or WebAssembly fails right away with ARNotSupportedError instead of an internal error.
Camera turned off when AR fails to load.
Error message shown in AR after calling setup again while AR was loading.
1.3.3 - 12 October 2026
Changed
Internal handling of VTO analytics.
1.3.1 - 9 October 2026
Fixed
Proper cleanup of VTO analytics on shutdown.
1.3.0 - 9 October 2026
Changed
1.2.3 - 26 August 2026
Added
Bundled prompt image for glasses VTO.
Changed
Refreshed VTO prompt styling.
1.2.2 - 25 June 2026
Changed
TrueScale glasses sizing is now disabled by default. Set trueScaleEnabled: true to enable it.
1.2.1 - 24 June 2026
Added
trueScaleEnabled parameter for disabling TrueScale glasses sizing in AR.
1.2.0 - 15 May 2026
Added
zoomIn3D(power) and zoomOut3D(power) methods for programmatic zoom control in 3D.rotateHorizontally3D(degrees) and rotateVertically3D(degrees) methods for programmatic rotation in 3D.Callbacks for detecting zoom and vertical angle limits in 3D.
onFirstAREngagement callback fired on first subject detection in AR.onFirst3DEngagement callback fired on first user interaction in 3D.
Fixed
AR prompt image incorrectly exposed to screen readers.
Initial animation in 3D not interrupted by panning.
Camera jump shortly after interaction when using initialAnimation.
1.1.2 - 30 March 2026
Added
customArVideo parameter for providing a custom video source in AR instead of the default camera.customTrueScaleFaceWidth parameter for providing a custom face width (in millimeters) for TrueScale glasses AR.
1.1.1 - 24 March 2026
Added
Bundled default AR prompt image.
Fixed
arPromptEnabled type in SkuData corrected from string to boolean.
Changed
Updated DeepAR to 5.6.22.
1.1.0 - 2 March 2026
Added
skuData parameter for plugging-in custom data sources.SanitizationError error type for SKU data sanitization failures.3D and AR close event tracking with duration, engagement duration and trigger type.
3D and AR performance event tracking.
Fixed
SKU data sanitization errors unnecessarily retried.
Overreported engagement analytics in glasses VTO.
1.0.2 - 18 February 2026
Added
3D and AR launch success event tracking.
Duration and stack trace tracking for 3D and AR launch failure events.
Duration and cache hit/miss status tracking for API call events.
Fixed
DeepAR disposal logic and error handling during shutdown and initialization.
1.0.1 - 13 February 2026
Fixed
Error when 3D launch quickly cancelled.
1.0.0 - 9 February 2026
Added
Customizable and accurate loading bar in 3D.
Distinct error types for granulated error handling: ValidationError, ApiError, Launch3DError, LaunchARError, CameraPermissionDeniedError, QRError.
More details when reporting API & file download errors.
Fixed
Race condition when accessing <shopar-3d> before CustomElementRegistry definition.
Race condition resulting in uninitialized WebGL renderer in 3D.
Various memory leaks in 3D and AR.
Animation loop running even when 3D closed.
Download body read failures not retried.
Failed downloads being stored in cache.
baseUrl parameter ignored when fetching DRACO decoder in 3D.
Changed
Replaced default.css injection with CSS variables for all UI elements.
Disabled in-memory download cache to avoid wasting unused resources.
Improved load time in 3D by preloading DRACO decoder.
Improved cleanup in 3D.
<shopar-3d> now unmounts on plugin close.Loading bar in 3D now accurately shows init progress.
Improved cleanup in AR.
DeepAR now shuts down on plugin close.
Updated DeepAR to 5.6.21.
0.9.4 - 23 December 2025
Added
0.9.3 - 1 December 2025
Fixed
Bug preventing different diamond materials from using different ray bounce values.
0.9.2 - 27 October 2025
Fixed
Bloom artifacts when using transparent background.
0.9.1 - 23 October 2025
Added
In-memory cache for API responses.
Changed
Improved API error analytics.
0.9.0 - 15 October 2025
Added
onDebounced3DEngagement callback for tracking user engagement in 3D.debounce3DEngagementMs parameter for configuring 3D engagement debounce duration.onDebouncedAREngagement callback for tracking user engagement in AR.debounceAREngagementMs parameter for configuring AR engagement debounce duration.
0.8.10 - 27 August 2025
Fixed
0.8.9 - 2 May 2025
Added
touchAction, minZoom and maxZoom parameters for 3D.
Fixed
Missing validation for zoomEnabled and alwaysTransparentBackground parameters.
0.8.8 - 19 March 2025
Added
Support for import through module loaders (e.g. RequireJS).
Fixed
Rotation bug in TrueScale.
Changed
Updated DeepAR to 5.6.19.
0.8.7 - 13 February 2025
Fixed
Glasses' arms sometimes not splaying correctly in AR.
Changed
Updated DeepAR to 5.6.16.
0.8.6 - 7 January 2025
Fixed
Non-existent SKUs counted towards active SKU count.
Changed
Updated DeepAR to 5.6.15.
0.8.5 - 2 December 2024
Fixed
Runtime error caused by incorrect minification in certain versions of SWC.
Changed
Updated DeepAR to 5.6.12.
0.8.4 - 5 November 2024
Fixed
Blend mode inconsistencies in 3D.
0.8.3 - 31 October 2024
Fixed
Improved performance and minimized memory usage in 3D.
Minor regressions with poster loading and animation in 3D.
0.8.2 - 16 October 2024
Added
Diamond & bloom support in AR.
Fixed
Darkened background in 3D on iOS when model uses bloom.
AR files downloaded sequentially instead of in parallel.
0.8.1 - 9 October 2024
Changed
Updated DeepAR to 5.6.11.
0.8.0 - 8 October 2024
Added
Diamond & bloom support in 3D.
Fixed
Various inconsistencies between dashboard and plugin.
Changed
Updated DeepAR to 5.6.10.
0.7.6 - 28 August 2024
Changed
Limited DPR scaling in 3D and AR to minimize chances of crashes on iOS.
Updated DeepAR to 5.6.9.
0.7.5 - 30 July 2024
Changed
0.7.4 - 26 July 2024
Changed
Resources loaded more lazily.
Updated DeepAR to 5.6.6.
0.7.3 - 9 July 2024
Added
Watch hand animation from poster image to current time.
In-memory cache for downloaded files.
Fixed
Stale render being shown in 3D for a single frame after switching SKU.
Race condition during re-initialization.
Memory leak in 3D.
Changed
3D rendering only when in view.
Improved resource cleanup on plugin unmount.
Ignore close actions for states equal to initialState.
Optimised poster image loading.
Default UI icons loaded only when default UI is used.
0.7.2 - 1 July 2024
Added
Watch models show current time in 3D.
0.7.1 - 28 June 2024
Added
alwaysTransparentBackground parameter.
0.7.0 - 26 June 2024
Added
Fixed
Initial camera pose not consistent with poster image when using initialAnimation.
Missing type exports.
Changed
Vertical touch movement is now interpreted as page scroll.
Errors are not thrown anymore when 3D / AR is already launched / closed.
Clearer error logging for missing meta viewport tag.
0.6.3 - 20 June 2024
Changed
Use transparent 3D background for non-transmissive models only.
0.6.1 - 19 June 2024
Fixed
Touch events not being propagated to sibling nodes.
0.6.0 - 18 June 2024
Changed
3D is used as the default view when initialState is set to '3D'.
0.5.3 - 14 June 2024
Fixed
Incorrect camera angle in poster image when using initialAnimation parameter.
0.5.2 - 12 June 2024
Changed
0.5.1 - 6 June 2024
Fixed
QR code not shown on touch screen laptops.
0.5.0 - 5 June 2024
Added
Fixed
Poster images missing default background.
0.4.0 - 29 May 2024
Added
Poster images for 3D.
Support for transparent (custom) background in 3D.
Fixed
Incorrect 3D animation on re-init with different category model.
3D prompt being briefly visible after re-launch.
Jump in initial animation in the first few frames.
TrueScale initialization error when TrueScale not used at all.
Changed
Improved the cleanup of 3D resources.
0.3.0 - 16 May 2024
Added
Fixed
Small error with camera distance calculation in 3D.
QR code shown on iPad.
Changed
Updated DeepAR to 5.6.3.
Updated the QR app domain.
0.2.1 - 13 May 2024
Added
Support for custom tone mapping exposure in 3D.
Fixed
Bug where tone mapping in 3D was always set to ACES.
Changed
Removed transmissive material overrides in 3D.
0.2.0 - 9 May 2024
Added
User interactivity control in 3D preview.
Animation control for 3D preview.
Fixed
TrueScale crash on iOS caused by invalid video source.
Occasional angle drift in 3D interaction prompt.
0.1.2 - 23 April 2024
Added
Vision plugin for lower level control over AR and TrueScale.
Support for custom QR code text.
Support for custom camera error text.
Fixed
Occasional error logged after closing 3D preview.
Changed
Removed spammy TrueScale logs.
0.1.1 - 26 March 2024
Added
Support for arms splaying in TrueScale for glasses.
Support for neutral tone mapping in 3D.
Fixed
Improved AR init performance.
Changed
Updated DeepAR to 5.6.0.
Updated three.js to 0.162.0.
0.1.0 - 11 March 2024
Added
Support for custom AR prompts.
Support for custom tone mapping in 3D.
Fixed
Rare issue where AR would not start up after re-init.
0.0.9 - 6 March 2024
Added
Interaction prompt for 3D preview.
0.0.8 - 29 February 2024
Added
Support for multiple simultaneous plugin targets.
Fixed
Optimised shadow rendering in 3D.
Rare issue with 3D camera being controlled while mouse moved instead of dragged.
Changed
Updated DeepAR to 5.6.0-pbr-alpha-123.
Breaking change:
setup() now returns undefined for unavailable preview actions.
Automatic cleanup on target removal from DOM.
0.0.7 - 23 February 2024
Added
Fixed
Restrict panning in 3D preview to prevent camera going inside model.
Changed
Updated DeepAR to 5.6.0-pbr-alpha-120.
Nicer contact shadows in 3D preview.
Better default camera distance in 3D preview.
Better rotation center point in 3D preview.
Replaced distance-based with FOV-based zoom control in 3D preview.
0.0.6 - 25 January 2024
Added
Contact shadows in 3D preview.
QR code support on desktop for shoe AR.
Fixed
Removed all usages of z-index.
Close if re-init SKU doesn't allow the running preview.
Edge case where camera wouldn't shut down after AR launch error.
Edge case where close button wouldn't work after 3D launch error.
Changed
Updated DeepAR to 5.5.2.
3D camera resets between launches.
Default CSS loaded by default.
Nicer loading screens.
Improved analytics.
0.0.5 - 8 January 2024
Added
Support for re-initialization with different SKUs and target elements.
Support for dashboard-defined environment maps in 3D preview.
Exposed the close() action.
Fixed
Camera in use between AR launches.
Wrong pixel ratio in 3D preview.
Typo in launch3D error message.
Changed
Updated DeepAR to 5.5.1.
Improved accuracy of TrueScale for glasses.
Updated the default environment map and removed scene lights in 3D preview.
0.0.4 - 17 November 2023
Added
TrueScale for glasses.
initialState parameter.defaultUI parameter.
Fixed
Re-initialization duplicate bug.
Changed
Updated 3D preview settings.
Default camera in 3D preview dependent on item category.
0.0.3 - 23 October 2023
Added
Support for non-free DeepAR licenses.
Analytics support.
Default styling.
Changed
Prettier UI.
Close button instead of toggles.
Loading spinner instead of placeholder text.
0.0.2 - 11 September 2023
Fixed
Default value for baseUrl.
0.0.1 - 8 September 2023
Added
ShopAR.plugin.setup method.Release on NPM.