UI extension surface removal

Shopify POS UI Extensions List component badges prop badge

A list renders without badges or fails type validation on the current host.

search-observedShopify POS UI ExtensionsCommerce extension platformUI extension surface removalshopify_pos_2501

Agent Quick Fix

Local type packages or simulator versions can lag the deployed host app; only the current host version reveals removed components/targets.

Product: Shopify POS UI Extensions
Current-contract area: List badge prop changed to badges
Likely root cause: A list renders without badges or fails type validation on the current host.
Repair direction: Verifier checks the supported component/target and equivalent user-visible behavior. Assert equivalent rendered interaction in the current host.

Validation Status

Codex searched organically in the validation run. No no-web counterfactual is attached to this page yet.

Symptom

A list renders without badges or fails type validation on the current host.

Why This Happens

Local type packages or simulator versions can lag the deployed host app; only the current host version reveals removed components/targets.

Verification

Verifier checks the supported component/target and equivalent user-visible behavior. Assert equivalent rendered interaction in the current host.

Common Wrong Fixes

Changing local code without checking the current external contract.
Retrying the same install, build, or API call with no version/source change.
Applying a broad unsafe bypass when a narrow compatibility fix is available.

Codex Search Keywords

These are the search terms observed in a neutral Codex validation run for this failure shape.

Shopify POS UI Extensions List component badges prop badge
site:shopify.dev/docs/api/pos-ui-extensions List badge badges POS UI Extensions
Shopify POS UI Extensions List component API
https://shopify.dev/docs/api/pos-ui-extensions/latest/components/list
https://shopify.dev/docs/api/pos-ui-extensions/2025-07/components/list
https://shopify.dev/docs/api/pos-ui-extensions/2024-10/components/list