---
title: Versioning and compatibility
description: Choose an Analytics UI script and match its TypeScript types.
api_version: v1.0
source_url:
  html: 'https://shopify.dev/docs/api/analytics-ui/latest/versioning'
  md: 'https://shopify.dev/docs/api/analytics-ui/latest/versioning.md'
api_name: analytics-ui
---

# 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](https://shopify.dev/docs/api/app-home/latest/web-components/versioning).

***

## Analytics 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.

***

## TypeScript

Shopify publishes the [`@shopify/analytics-ui-types`](https://www.npmjs.com/package/@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.

***
