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.

Shopify POS UI ExtensionsCommerce extension platformUI extension surface removalshopify_pos_2501

Agent Quick Fix

Repair against the current Shopify POS UI Extensions contract, then keep the change narrow and source-backed.

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.

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.

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

Source Trail