UI extension surface removal

Shopify POS UI extensions icon names deprecated icon blank unknown glyph

A host-version upgrade replaces the icon with a blank/unknown glyph.

Shopify POS UI ExtensionsCommerce extension platformUI extension surface removalshopify_pos_2507

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: Deprecated Icon name removed
Likely root cause: A host-version upgrade replaces the icon with a blank/unknown glyph.
Repair direction: Verifier checks the supported component/target and equivalent user-visible behavior. Assert equivalent rendered interaction in the current host.

Symptom

A host-version upgrade replaces the icon with a blank/unknown glyph.

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 icon names deprecated icon blank unknown glyph
shopify ui extensions icon name POS Icon source
Shopify POS UI Extensions Icon
https://shopify.dev/docs/api/pos-ui-extensions/latest/components/icon
https://shopify.dev/docs/api/pos-ui-extensions/2025-07/components/icon
https://shopify.dev/docs/api/pos-ui-extensions/2025-07/api-versioning
https://shopify.dev/docs/api/pos-ui-extensions/2025-10
's-icon' in https://shopify.dev/docs/api/pos-ui-extensions/2025-10