UI extension surface removal

Shopify POS UI Extensions ActionItem removed

Extension build/runtime fails after current POS typings/host remove ActionItem.

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: ActionItem component removed
Likely root cause: Extension build/runtime fails after current POS typings/host remove ActionItem.
Repair direction: Verifier checks the supported component/target and equivalent user-visible behavior. Assert equivalent rendered interaction in the current host.

Symptom

Extension build/runtime fails after current POS typings/host remove ActionItem.

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 ActionItem removed
site:shopify.dev/docs/api/pos-ui-extensions ActionItem
Shopify POS UI extensions components List ActionItem Button
Shopify POS UI extensions reference components
https://shopify.dev/docs/api/pos-ui-extensions
'ActionItem' in https://shopify.dev/docs/api/pos-ui-extensions
https://shopify.dev/docs/api/pos-ui-extensions/latest/components/actionitem
https://shopify.dev/docs/api/pos-ui-extensions/latest/components/actionitem?version=2025-04
site:shopify.dev/docs/api/pos-ui-extensions/latest/components/actionitem "Not supported"
https://shopify.dev/docs/api/pos-ui-extensions/2025-07/components/actionitem

Source Trail