Updating Shopify App Bridge
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
Anchor link to section titled "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.
Ensure compatibility with the new Shopify admin domain
Anchor link to section titled "Ensure compatibility with the new Shopify admin domain"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:
- Ensure that the content security policy includes
admin.shopify.com. - Update App Bridge to version 2.0.5 or higher. We recommend updating to version 3.2.0 or higher.
- Initialize App-Bridge with the
hostparameter.
Support Shopify admin performance tracking
Anchor link to section titled "Support Shopify admin performance tracking"Shopify uses Web Vitals to determine the performance of your app in the Shopify admin. To enable Shopify to gather Web Vitals metrics, you might need to update your version of App Bridge.
- For apps that use App Bridge 2.x, you need to use version 2.2.0 or higher.
- For apps that use App Bridge 3.x, you need to use version 3.2.0 or higher.
Where possible, you should use version 3.2.0 or higher.
Updating your app to a version that supports admin performance tracking is a prerequisite to reaching Built for Shopify status.