Skip to main content

Last Update: 24/08/2026

Changelog

Version history of the ARShades Shopify Plugin. Versioning follows SemVer.

Add to Cart from inside the VTO — 2026-08-24

Shoppers can now add the frame they are trying on to the cart without leaving the try-on. The button lives inside the VTO itself, next to the controls, and the merchant chooses what happens next: go to checkout, go to the cart, or stay in the try-on with a confirmation.

The app version is unchanged at 1.1.0 — the feature ships through the VTO bundle and the theme app extension, not through an app release.

Added

  • Add to Cart button inside the VTO, off by default. Enable it on the VTO Embed block, together with the label and the post-add behaviour (checkout / cart / stay). See Add to Cart.
  • Control over how the button looks: colour, hover colour, text colour, corner radius, padding and font size. Leaving a colour empty means "use the catalogue's brand colour" — which is why those settings deliberately have no default.
  • Control over where the button sits: three vertical positions (above the controls, above the variant menu, below the variant menu), three horizontal alignments, and a fine offset of ±120 px on each axis for the cases where a theme's control stack needs a nudge.
  • Manual integrations can use the same button by speaking the ars-vto/v1 bridge directly: the player emits the intent, the page performs the add. See Manual Integration.

Notes

  • The player never talks to Shopify. It is cross-origin and only emits the intent; the storefront performs the add. No new OAuth scope is required.
  • The button is protected against the double tap: a second tap while the first add is still in flight is discarded, so one purchase intent never becomes two units in the cart.
  • In single view there is no variant menu, so above the variant menu and below the variant menu place the button in the same spot — below the controls.

Distribution change — 2026-08-20

ARShades VTO is now published on the Shopify App Store with limited visibility, and merchants install it themselves from https://apps.shopify.com/arshades-vto. The Custom App installation link previously provided by our team is no longer used for new stores.

This is a distribution change only: plugin functionality is unchanged and the current version remains 1.1.0. See Installation.

1.1.0 — 2026-06-11

Added

  • Variant Sync (Last Tried) — optional, per-block. When the shopper closes the VTO, the product page switches to the last variant they tried (price, gallery and Add to cart update accordingly). Enable it on the ARShades Product VTO block, or from the storefront via window.ARShadesVTO.openModal(id, { syncLastTriedVariant: true }). A cancelable arshades:last_tried_variant_applied event is exposed for custom integrations. See Variant Sync.
  • Secure ars-vto/v1 bridge (origin-locked postMessage) between the storefront and the VTO player.

Fixed

  • AJAX themes (Horizon / Online Store 2.0) compatibility — the VTO and 3D buttons now open the currently selected variant even when the theme switches variant without reloading the page. Previously they always opened the initial variant.

Changed

  • Per-context Single SKU — the Single SKU setting on the product-page button is now independent from the app embed (cards/collections).

1.0.0 — 2026-04-02

Initial production release.

Added

  • Guided setup wizard: license verification, catalogue creation, product sync, and design configuration.
  • Product synchronisation (SKU/EAN matching) against the ARShades catalogue, with CSV filtering and a dedicated Assets management page.
  • VTO Button app block for product pages, with full button/modal styling options.
  • VTO Embed (collection-card buttons and async loader).
  • 3D Viewer app block (ARViewer) with AR on supported devices.
  • ARPDMeter component for pupillary-distance measurement.
  • Shopify Pixel analytics events for VTO/3D usage.