Determine if Shop has checkout.liquid customizations using Admin API

Topic summary

Topic: Detecting whether a shop uses legacy checkout.liquid customizations vs Checkout Extensibility via the Shopify Admin API.

  • Context: Some features (Shopify Functions) don’t work with checkout.liquid. Developers need a reliable API signal to decide if functions can be applied.
  • Attempted approach: Querying the CheckoutBranding object (Admin GraphQL) to infer use of Checkout Extensibility/branding API. This can return data, but it’s not a dependable indicator of full upgrade status.
  • Current gap: No clear feature flag or ShopFeatures field exists to definitively identify a shop’s checkout type.

Key terms:

  • checkout.liquid: Legacy theme-based checkout customization.
  • Checkout Extensibility: New extensible, API-driven checkout customization framework.
  • Admin API (GraphQL): Shopify’s administrative API for querying shop capabilities.

Outcome and status:

  • Action: A feature request will be logged to add a flag that identifies checkout type.
  • Resolution: Not resolved; no reliable API signal available yet. Developers must use imperfect checks (e.g., CheckoutBranding) until a new flag is introduced.
Summarized with AI on January 10. AI used: gpt-5.

Hi Ocastx,

I believe you could query the CheckoutBranding object which would return data if a merchant is using the branding API/ checkout extensibility.

1 Like