Dev Dashboard now shows how often your app causes Checkout and Customer Account UI Extensions to fail to load, and on which stores. Health statuses and alerts are also expected to appear for merchants soon.
If an extension fails to load, it simply disappears from the buyer's screen, making the problem hard for developers to spot.
Operations on your app's home shows the failure rate and a ranking of installs with the most failures, while Logs records failure events.
Applies to: Checkout UI Extensions Customer Account UI Extensions
How many times the Extension loaded during the selected period, and what percentage of those loads failed.
Top extension installations by failure rate.The current versionof the Extension, ranked by the stores and Extension targets where it fails most. Only installs with 10 or more loads are included. Each row links to that store's mount failure logs.
A new event is recorded each time a mount fails.store/extension/target/result can be used to filter.
Only app-caused failures are reflected in the failure rate, rankings, and Logs.
These are excluded from the metrics and don't appear in Logs.
Merchants will also be able to use Settings > Apps to see the same health information for the Extensions installed on their store. The current version of each Extension gets a status based on itsloads over the last 7 days.
| Status | Failure rate condition | Duration | Impact on merchants |
|---|---|---|---|
| Not evaluated | Fewer than 10 loads per week | — | No status shown |
| Warning | Confident that over 5% are failing | 3 days | Status shown in Settings > Apps |
| Critical | Confident that over 50% are failing | 2 days | Status shown + alert in the Shopify admin |
Check Extension mount failure rate in the Operations section.
Go from a ranking row to that store's mount failure logs.
Filter by store/extension/target/result to trace the cause.
Failures caused by Shopify, the network, or the browser are excluded. The metric assumes any failures shown can be treated as issues in your own code.
Both the ranking and the merchant-facing status apply to the extension's current version. After you release a fix, evaluation appears to be based on loads of the new version.
The ranking only includes installations with 10 or more loads. For merchants, fewer than 10 loads per week means no evaluation. Low-traffic stores are less likely to show numbers.
Rankings are broken down by "store × extension target," and Logs can also be filtered by target. Use this to pinpoint failures that happen only in a specific placement.
If the failure rate stays above 50% for 2 consecutive days, it becomes Critical and an alert appears in the merchant's admin.a routine of checking the Dev Dashboard after each deploymentUnless you build in this routine, you'll only find out when merchants contact you. The article doesn't say whether this metric is available via API or webhooks.