Skip to main content

Versioning and compatibility

Analytics UI and Polaris use separate version schemes. Their version numbers don't correspond. For Polaris versions, see Versioning for web components.


Anchor to Analytics UI versionsAnalytics UI versions

Analytics UI uses semantic versioning. We recommend analytics-ui-1.js for production. It serves the latest stable 1.x release, so your app receives compatible minor upgrades and fixes without changing the script tag.

The unversioned analytics-ui.js script serves Analytics UI 1.0. It serves the same release as analytics-ui-1.0.js. To receive newer 1.x releases, switch to analytics-ui-1.js. To stay on a specific release, use its major and minor version in the script URL.


Shopify publishes the @shopify/analytics-ui-types package for TypeScript. Match its version to the script that your app loads. For analytics-ui-1.js, use the ^1.0.0 range so that your types receive compatible updates in the 1.x series.


Was this page helpful?