Skip to content

Adapter feature matrix

Derived by reading each adapter's actual Adapter# method definitions (not its README) — portage-ucp-<platform>/lib/portage/ucp/<platform>/adapter.rb — plus the capability registry's advertisement rule in portage-ucp/lib/portage/ucp/capability.rb (Capability#advertised_for?: a capability is advertised as soon as any one of its backing methods is overridden). ✅ = implemented for real, — = not implemented (method isn't overridden, so the action isn't advertised at all), ⚠️ = implemented but with a caveat noted in a footnote below. Derived 2026-09-24.

Shopify Wix WooCommerce BigCommerce Magento Etsy Instagram
Catalog search ✅ ✅ ✅ ✅ ✅ ✅ ✅
Product detail ✅ ✅ ✅ ✅ ✅ ✅ ✅
Catalog lookup (batch by id) ✅ — — — — — —
Cart (get/create/update/cancel) ✅ ✅ ✅ ✅ ✅ — —
Checkout create ✅ ✅ ✅ ✅ ✅ ✅ ✅
Checkout get ✅ ✅ ✅ ✅ ✅ ✅ ✅
Checkout update ✅ ✅ ✅ ✅ ✅ —1 —1
Checkout complete ✅ ✅ ✅ ✅ ✅ —1 —1
Checkout cancel ✅ ✅ ✅ ✅ ✅ —1 —1
Discount codes ✅ — — — — — —
Fulfillment options ✅ — — — — — —
Order get ✅ ✅ ✅ ✅ ✅ ✅ ⚠️2
Order cancel ✅ — — — — — —
Order refund ✅ — — — — — —
Order return (RMA) ✅ — — — — — —
Payment method / saved address / shopper data — — — — — — —
Auth type Admin + Storefront token Site-scoped OAuth access token Consumer key/secret (Basic Auth) Client id + access token Admin bearer token OAuth 2.0 (PKCE) access token + x-api-key Long-lived Graph API (Page/catalog) token
Standalone exe ✅ ✅ ✅ ✅ ✅ ✅3 ✅3

See Capability coverage for the same data organized by UCP capability id rather than by adapter, and Adapter requirements for the exact environment variables each executable reads.


  1. Etsy's and Instagram's public APIs have no cart/checkout endpoint at all — create_checkout/get_checkout return a redirect link to the platform's own hosted checkout, so there's nothing for update_checkout/complete_checkout/cancel_checkout to back. See the Etsy adapter and the Instagram adapter. ↩↩↩↩↩↩

  2. Instagram's get_order is deprecated: Meta removes Order Management endpoints on 2026-10-27. After that date this adapter is catalog search/product + checkout handoff only — there is no replacement order-status API on Meta's side. ↩

  3. Etsy and Instagram gain exe/ via the feat/etsy-exe and harden/instagram branches (not yet merged as of this writing) — describing the post-merge state, all seven bundled adapters ship the same standalone executable and PORTAGE_UCP_CONFIG hook (see Library usage). ↩↩