Keeping your app up to date is important to ensure that users have a high-quality, performant, and secure experience. You should periodically update your app's version of Shopify App Bridge to the latest version to ensure that it continues to function and has access to all of the latest features. You might need to make additional updates to your app to support certain features.

## Update your app

To update an app to the latest version of App Bridge, use the following guides. Start with the guide that indicates how to upgrade from the version of App Bridge that your app currently uses and then follow all subsequent guides.

- [Upgrading from legacy SDKs to Shopify App Bridge](/docs/api/app-bridge/previous-versions/migrating-legacy)
- [Upgrading from App Bridge 1.x to 2.0](/docs/api/app-bridge/previous-versions/migrating-to-2)
- [Upgrading from App Bridge 2.x to 3.0](/docs/api/app-bridge/previous-versions/migrating-to-3)

## Ensure compatibility with the new Shopify admin domain

 > Caution:
 > As a result of our [efforts to consolidate Shopify's admin domains](https://www.shopify.com/partners/blog/september-product-updates-for-partners-and-developers), we no longer support apps built with the Embedded App SDK (EASDK), the POS App SDK, or App Bridge version 1.x.
 >
 > Apps built using unsupported libraries might experience degraded functionality, including longer load times. Banners and screens indicating that the app is outdated will be displayed to users.

Stores loading your app might use the old `myshopify.com` domain, or the new `admin.shopify.com` domain.
To ensure that your app continues to work properly with stores that use the new domain, do the following:

 1. [Ensure that the content security policy includes `admin.shopify.com`](/docs/api/app-bridge/previous-versions/app-bridge-from-npm/app-setup#set-the-frame-ancestors-directive).
 2. [Update App Bridge](#update-your-app) to version 2.0.5 or higher. We recommend updating to version 3.2.0 or higher.
 3. [Initialize App-Bridge with the `host` parameter](/docs/api/app-bridge/previous-versions/app-bridge-from-npm/app-setup#initialize-shopify-app-bridge-in-your-app).

## Support Shopify admin performance tracking

<p>Shopify uses <a href="https://web.dev/vitals/">Web Vitals</a> to determine the performance of your app in the Shopify admin. To enable Shopify to gather Web Vitals metrics, you might need to update to the latest version of App Bridge by adding the <a href="/docs/api/app-bridge-library#getting-started">App Bridge script</a> to your app's <code>head</code>. The App Bridge script can exist alongside App Bridge installed as a packaged dependency and does not require a full migration.</p><p>Updating your app to a version that supports admin performance tracking is a prerequisite to reaching <a href="/docs/apps/store/built-for-shopify">Built for Shopify</a> status.</p>