Shopify Storefront API: Wat is gewijzigd en waar u actie moet ondernemen

De Shopify Storefront API is een publieke GraphQL API waarmee ontwikkelaars volledig aangepaste shopping experiences op elk platform kunnen bouwen, van headless storefronts tot mobiele apps en AI-agenten. In 2026 ontwikkelt het zich sneller dan ooit: versie 2026-04 is de huidige stabiele release, 2026-07 is vandaag (30 juni 2026) beschikbaar als release candidate met breaking changes, en versie 2024-10 eindigt in oktober, wat teams vijf maanden geeft om te migreren. Als uw headless store momenteel niet op een ondersteunde versie draait, tikt de klok al.

Belangrijkste punten

• 2026-04 is de huidige stabiele Storefront API versie; 2026-07 is de actieve release candidate met breaking changes in cart en product query structuren.
• De legacy versie 2024-10 eindigt in oktober 2026, custom builds hebben herstelkosten van 8.000 tot 40.000 euro als het te laat wordt.
• Versie 2025-10 introduceerde de visitorConsent parameter op de @inContext directive, met GDPR/privacy-toestemming gecodeerd in de checkout-URL.
• Vanaf 2026-07 geeft de Cart PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION en DELIVERY_SELECTED_OPTION_NOT_AVAILABLE waarschuwingen af zodat uw UI deze kan tonen.
• Storefront MCP tools get_cart/update_cart zijn deprecated ten faveure van UCP Cart MCP, met ondersteuning tot 31 augustus 2026.

Het versiemodel: hoe Shopify's driemaandelijkse releasecyclus werkt

Shopify geeft elke drie maanden een nieuwe Storefront API versie uit: januari, april, juli en oktober. Elke stabiele versie verandert niet gedurende haar ondersteunde levensduur, en elke stabiele versie wordt minimaal 12 maanden ondersteund, wat betekent dat er minstens negen maanden overlap is tussen twee opeenvolgende releases. Die overlap is uw migratievenster.

Er zijn drie tracktypen om te begrijpen:

• Stabiel (bijv. 2026-04), veilig voor productie, gegarandeerde backward compatibility.
• Release candidate (bijv. 2026-07), gepubliceerd op dezelfde dag als de nieuwe stabiele release, nu beschikbaar voor testen maar niet aanbevolen voor productie.
• Unstable, continu bijgewerkt, functies kunnen zonder waarschuwing verdwijnen; alleen dev/test.

Een belangrijk detail: als uw integratie een ontoegankelijke (ingetrokken) versie targetd, leidt Shopify automatisch door naar de oudste beschikbare stabiele versie. De X-Shopify-API-Version response header wijkt af van wat u aanvraagde, dit is uw signaal dat u van een ondersteunde versie bent afgedwaald en risico loopt op stille breaking changes.

Voor apps gepubliceerd in de Shopify App Store zijn de risico's hoger. Apps die na de upgraaddeadline onondersteunde resources blijven gebruiken, worden uit de App Store verwijderd, met gebruikers die minimaal zeven dagen geen installatie kunnen uitvoeren.

API-versieoverzicht: stabiel, release candidate en unstable tracks

Wat is werkelijk gewijzigd in 2026-04 (de huidige stabiele versie)

Hydrogen skeleton bijgewerkt naar 2026-04. Als u uw Hydrogen config op 2026-01 hebt vastgezet, dient u dit bij te werken. Het skeleton package (skeleton@2026.4.0) targetd nu 2026-04 voor alle Storefront API en Customer Account API calls.

Metaobject-toegang in Shopify Functions. 2026-04 maakt het mogelijk voor Shopify Functions om rechtstreeks metaobject data op te vragen. Als u Functions-gebaseerde discount of delivery logica hebt die zou kunnen profiteren van het lezen van metaobject definities op runtime, is dit nu beschikbaar.

JSON metafield limiet op 128KB. Vanaf API versie 2026-04 beperkt Shopify JSON metafield waarden tot 128KB. Als uw storefront grote JSON metafields leest, controleer uw data nu voordat een versie-upgrade payloads stilzwijgend breekt.

De 2026-07 breaking changes: wat headless builds moeten patchen

Shopify's zomer 2026 editie (codenaam Compass) bracht 65 productupdates. De Storefront API 2026-07 introduceert breaking changes in cart en product query structuren die elke headless build beïnvloeden, Hydrogen, Next.js Commerce, Nuxt of volledig custom.

Dit vereist aandacht voor oktober:

Cart waarschuwingssignalen. Vanaf 2026-07 geeft het Cart object twee nieuwe waarschuwingstypen af:

• PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION, als een cartlijn een product bevat dat niet beschikbaar is op de locatie van de koper. Elke aangetaste cartlijn geeft zijn eigen waarschuwing, met de target ingesteld op de Cart Line ID zodat u het terug kunt toewijzen aan de juiste lijn in uw UI.
• DELIVERY_SELECTED_OPTION_NOT_AVAILABLE, als de gekozen delivery optie van een koper niet meer beschikbaar is (bijvoorbeeld na een cartadres wijziging). Eerder schakelde het systeem delivery opties stilzwijgend over zonder bericht aan de koper. Nu kunt u dit programmatisch detecteren en de koper vragen opnieuw te kiezen.

Verwijdering metaobject enum. De verouderde PRIVATE en PUBLIC_READ access control enums in metaobject definities worden in 2026-07 verwijderd. Als uw app of storefront naar deze enum waarden verwijst, update naar het huidige access control model voordat de release stabiel wordt.

Herstructurering discount velden. 2026-07 herstructureert discount-gerelateerde velden op de Cart. Als uw storefront aangepaste discount display of coupon logica heeft, begin nu met refactoring tegen de release candidate. Hydrogen gebruikers krijgen codemods voor meeste veld hernoemingen; aangepaste frameworks zijn op eigen houtje, met herstelinschattingen tussen 8.000 en 40.000 euro afhankelijk van storefront complexiteit.

De oktober 2026 deadline is bindend. API versie 2024-10 eindigt oktober 2026. Vijf maanden klinkt comfortabel, het is niet, eenmaal u staging deploys, regressietests en het feit in rekening brengt dat cart logica typically het meest fragiele onderdeel van elke headless stack is. Begin nu met testen tegen de 2026-07 release candidate.

Privacy-conforme checkouts met @inContext visitorConsent

Dit arriveerde in 2025-10 en blijft een van de meest praktisch nuttige Storefront API toevoegingen in recent geheugen. De @inContext directive accepteert nu een visitorConsent parameter, waarmee ontwikkelaars kopertoestemmingsvoorkeuren, analytics, voorkeuren, marketing en data verkoop naar cart operations kunnen doorgeven.

De mechanica zijn schoon: u codeert toestemming in de cartCreate of cartBuyerIdentityUpdate mutation als volgt:

@inContext(visitorConsent: {
  analytics: true,
  preferences: true,
  marketing: false,
  saleOfData: false
})

De toestemmingsinformatie wordt automatisch gecodeerd en opgenomen in de resulterende checkoutUrl, wat privacy compliance gedurende het gehele checkoutproces waarborgt. Shopify leest de _cs parameter die het aan de URL toevoegt tijdens checkout, verwijder deze niet.

Dit is belangrijk voor GDPR en soortgelijke regelingen. Headless storefronts die eerder geen schone manier hadden om toestemming van een cookie banner door te geven naar de checkout hebben nu een first-party mechanisme ingebouwd in de API zelf. Er is geen excuus voor een moderne headless build om dit niet te implementeren.

Rate limits: de nieuwe bot en agent realiteit

Shopify past nu strengere rate limits toe op bots en agenten die de Storefront API en Shopify-hosted online store paginas benaderen. Bots en agenten die hun verzoeken niet ondertekenen, zijn onderhevig aan de strengste limieten; om in aanmerking te komen voor hogere rate limits, ondertekenen operators verzoeken met Web Bot Auth.

Voor legitieme merchants en ontwikkelaars zijn de praktische implicaties tweeërlei:

1. Als u een aangepaste crawler, prijsaggregator of AI shopping agent exploiteert die Storefront API endpoints raakt, onderteken uw verzoeken of verwacht throttling.
2. Als u een Storefront MCP integratie bouwt (zie volgende sectie), zorg dat uw agent profiel correct geregistreerd is zodat het de passende access tier ontvangt.

Merk op dat de Storefront API geen rate limit heeft op het aantal legitieme koperverzoeken, het is ontworpen om via flash sales te schalen zonder gelijktijdigheid te beheren. De nieuwe limieten richten zich specifiek op schadelijk of ongeïdentificeerd bot verkeer.

Agentic commerce: Storefront API ontmoet UCP en MCP

Dit is de meest structureel significante verschuiving in de Storefront API's rol in 2026. De API is niet langer alleen de backbone voor headless mensgericht gerichte storefronts. Het is nu het ingangspoint voor AI agenten.

Shopify ontwikkelde samen met Google het Universal Commerce Protocol (UCP) als open standaard voor hoe AI agenten met merchants transacteren. UCP dekt de volledige commerce journey van discovery via carts naar checkout, en het heeft brede industriesteun inclusief Amazon, Meta, Microsoft, Salesforce, Stripe en Wayfair.

Voor ontwikkelaars is het concrete implementatie oppervlak de Storefront MCP server. Elke Shopify store heeft zijn eigen MCP endpoint dat storefront functies toont inclusief product search, cart operations en policy vragen. De search_catalog, lookup_catalog en get_product tools voldoen aan de UCP specificatie.

Kritische migratieopmerking: De legacy Storefront MCP cart tools (get_cart en update_cart) worden deprecated ten faveure van de UCP Cart MCP. De verouderde tools worden ondersteund tot 31 augustus 2026, dit is hetzelfde kwartaal als de 2024-10 API sunset. Twee migraties convergeren op dezelfde herfsdeadline.

Als u een branded agent of aangepaste AI shopping experience bouwt, is de architectuur eenvoudig:

• Gebruik Storefront MCP voor catalog search en product detail retrieval.
• Gebruik UCP Cart MCP voor cart operations (add, update, read line items).
• Gebruik Checkout Kit (of de aankomende Checkout MCP, momenteel in partner preview) voor de payment handoff.

Voor merchants die geen aangepaste agenten bouwen, is de praktische actie eenvoudiger: zet de AI channels die u wilt verkopen in Shopify admin via Agentic Storefronts aan, en Shopify handelt het protocol werk af. ChatGPT, Google AI Mode, Perplexity en Microsoft Copilot zijn allemaal bereikbaar via een enkele admin configuratie.

Authenticatie en access tokens: wat verandert in januari 2027

Een item dat buiten de 2026 API versiecyclus valt maar direct Storefront API integraties beïnvloedt: vanaf 1 januari 2027 moeten alle publieke apps vervallende offline access tokens gebruiken voor Admin API calls. Dit is een Admin API wijziging, geen Storefront API wijziging, maar veel integraties gebruiken beiden, als uw headless build op een langdurig Admin API token voor backend operations (inventory sync, order management, metafield writes) vertrouwt, moet u die migratie naast uw Storefront API versie upgrade plannen.

Uw migratiechecklist voor rest 2026

Hier is de opeenvolgende actielijst, gesorteerd op urgentie:

1. Controleer uw huidence vastgezette versie. Open uw Hydrogen config of GraphQL query headers. Alles ouder dan 2025-07 heeft onmiddellijke aandacht nodig.
2. Test tegen 2026-07 RC. Zet een staging environment op tegen de release candidate. Focus op cart mutations en aangepaste discount display logica.
3. Implementeer visitorConsent op @inContext. Als uw headless build niet al cookie toestemming door naar de checkoutUrl geeft, voeg het nu toe. Het vereist API versie 2025-10 of later.
4. Vervang verouderde metaobject enums. Verwijder alle PRIVATE of PUBLIC_READ verwijzingen voordat 2026-07 op 1 juli stabiel wordt.
5. Migreer van Storefront MCP cart tools naar UCP Cart MCP. Deadline: 31 augustus 2026.
6. Controleer JSON metafields > 128KB. Vereist voor elke 2026-04+ upgrade.
7. Registreer een Web Bot Auth handtekening als u bots of agenten exploiteert die Storefront API endpoints raken.

Als u hands-on hulp nodig hebt bij het plannen of uitvoeren van deze migraties, de Shopify developer services die ik aanbied dekken versie upgrades, headless architectuur reviews en Storefront API performance audits.