Shopify Headless en Storefront API: Wat Is Werkelijk Veranderd en Waarom Het Ertoe Doet

Als je tot nu toe met een Storefront API-versie uit 2024 werkt, loopt de tijd af. Shopify's platform beweegt snel in 2026, en de veranderingen dit moment zijn groter dan de gebruikelijke driemaandelijkse opschoning. Hier is een praktijkgerichte blik op wat eraan komt, wat breekt en waar de echte kans zit.

Storefront API 2026-07: Wat Breekt Voor Oktober

Shopify's Summer 2026 Edition (codenaam "Compass") levert 65 productupdates op, en de Storefront API 2026-07 release candidate is waar developers op moeten focussen. Het introduceert breaking changes in cart en product query-structuren die elke headless build beïnvloeden, of je nu op Hydrogen, Next.js Commerce, Nuxt of een custom stack bent. De oude 2024-10 API-versie verdwijnt in oktober 2026, waardoor teams vijf maanden hebben om te migreren.

Twee veranderingen verdienen onmiddellijke aandacht:

• PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION waarschuwing. Vanaf 2026-07 geeft het Cart object een PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION waarschuwing af wanneer een cartlijn een product bevat dat niet beschikbaar is op de locatie van de koper. Elke betreffende cartlijn retourneert zijn eigen waarschuwing, met een target ingesteld op de Cart Line ID zodat je het in je UI kunt mappen. Als je over markten verkoopt, moet je frontend deze waarschuwingen netjes afhandelen in plaats van producten stilletjes te verbergen.
• DELIVERY_SELECTED_OPTION_NOT_AVAILABLE waarschuwing. Eerder, als de gekozen afleveringsoptie van een koper niet beschikbaar werd (na cartadres- of inhoudswijzigingen), schakelde het systeem automatisch naar een ander option zonder iemand op de hoogte te stellen. Versie 2026-07 geeft nu een DELIVERY_SELECTED_OPTION_NOT_AVAILABLE waarschuwing af zodat je kopers kunt vragen om te bevestigen of een nieuw option te kiezen.

Voor Hydrogen-gebruikers levert Shopify codemods die de meeste structural field renames afhandelen. Ze zullen custom discount logic niet repareren, dus als je store tiered pricing, BOGO rules of market-specifieke discounts heeft, is die migratie aan jou.

Ook opgemerkt: de PRIVATE en PUBLIC_READ metaobject enums worden in 2026-07 verwijderd. Vervang deze voor 1 juli als je ze gebruikt.

Storefront API Versieoverzicht

Shopify Scripts Is Verdwenen. Echt Waar, Dit Keer.

Dit is jaren van tevoren aangekondigd, maar de deadline is nu echt. Vanaf 15 april 2026 kun je Shopify Scripts niet langer maken, bewerken of publiceren. Na 30 juni 2026 stoppen Scripts volledig met werken. Als je store nog altijd op Ruby-gebaseerde Scripts vertrouwt voor custom discounts, line item rules of shipping logic, is het migratiepad Shopify Functions of een public app. Er is geen verlenging van deze deadline.

Verbeterde Auth-stromen Voor Headless Checkouts

Een stille maar belangrijke update uit de recente changelog: verbeterde authenticatiestromen van cart naar checkout bevatten nu ondersteuning voor vaulted cards en store credit, wat de kopersexperiëntie specifiek voor headless storefronts verbetert. Dit sluit een gat dat jarenlang friction in headless builds heeft veroorzaakt, waar authenticated checkout-functies achter liepen op de standaard Liquid-gebaseerde ervaring.

Gerelateerd: de GraphQL Admin API bevat nu een cartToken veld op het Order object, waardoor developers de carttoken kunnen openen die gebruikt is om een order te creëren. Dit maakt het gemakkelijker om de volledige funnel van een headless cartsessie tot en met de fulfillment record te traceren.

Agentic Commerce Is Geen Toekomstige Trend. Het Werkt Al.

Dit is de grootste architectural shift die je nu moet begrijpen, en het herschrijft enkele aannames over wat headless überhaupt betekent.

Op 11 januari 2026 kondigde Shopify zijn agentic commerce platform aan, gebouwd op drie pijlers: het Universal Commerce Protocol (UCP), een open standard samen met Google ontwikkeld; per-store Storefront MCP servers; en een Agentic Plan voor brands nog niet op Shopify. Tegen eind maart 2026 activeerde Shopify Agentic Storefronts standaard voor elke store op het platform. Je producten worden al via de Shopify Catalog gesyndicated tenzij je hebt afgemeld.

De getallen achter dit zijn significant. Sinds januari 2025 is AI-gedreven traffic naar Shopify stores 8x per jaar gegroeid, terwijl orders van AI-powered searches 15x zijn gestegen. Shopify merchants zijn nu te vinden in ChatGPT, Microsoft Copilot, AI Mode in Google Search en de Gemini app.

UCP is samen met Google ontwikkeld en wordt ondersteund door Amazon, American Express, Etsy, Mastercard, Meta, Microsoft, Salesforce, Stripe, Target, Walmart en Visa. Als een nieuw AI platform UCP adopteert, zijn Shopify merchants automatisch klaar om daar te verkopen zonder aanvullende integratie. Het protocol dekt cart creation, checkout, payment en post-purchase af op elk platform en payment processor.

Op 22 april 2026 flipte Shopify ook de Storefront Catalog MCP server om UCP te implementeren. Als je een custom AI agent integratie op top van een Hydrogen storefront hebt gebouwd, zijn de oude tool names en endpoint verouderd, met de nieuwe effen effectief 30 mei en oude versies sunset op 15 juni.

Wat Dit Voor Headless Architecture Betekent

Hier wordt het gesprek interessant. Het klassieke argument voor headless was: ontkoppel alles voor maximale flexibiliteit. Dat argument heeft nog steeds waarde voor performance en design control. Maar er is nu een tegenargument dat commercieel uitmaakt.

AI agents (ChatGPT, Gemini, Copilot) lezen gestructureerde catalogusgegevens en plaatsen orders zonder je CSS of custom frontend ooit te laden. Als je headless stack buiten Shopify's catalog graph bestaat, kunnen die agents je producten niet zien. Gekoppeld blijven aan Shopify's data plane via de Storefront API en Catalog is wat je in AI-bemiddelde aankoopfunnels brengt.

Rate Limits: Bots en Agents Nu Anders Behandeld

Shopify past nu strengere rate limits toe op bots en agents die de Storefront API en Shopify-hosted online store pagina's openen. Bots en agents die hun requests niet ondertekenen, onderliggen de strengste limits. Om in aanmerking te komen voor hogere rate limits, moeten operators requests ondertekenen met Web Bot Auth. Als je crawlers, AI agents of ander automated tooling tegen je storefront draait, registreer en onderteken je requests nu.

Wie Moet In 2026 Echt Headless Gaan?

Headless is niet geschikt voor elke merchant, en het eerlijke antwoord is niet veel veranderd:

• Sterk geval voor headless: Jaarlijkse GMV boven 2 miljoen dollar waar performance improvements meetbare revenue impact hebben, in-house JavaScript developers of een lang termijn agencypartner met Hydrogen ervaring, content-commerce hybrid stores waar editorial content en product pages diep geïntegreerd zijn.
• Sla het nu over: Nieuwe stores onder 1 miljoen dollar. Beheers je Liquid theme eerst. Het performance plafond op een goed geoptimaliseerde Hydrogen build is hoger, maar de kosten zijn ongeveer 3 tot 5 keer die van een traditionele build, app compatibility vereist actieve re-engineering (veel mid-tier apps in de Shopify App Store bieden in 2026 nog steeds geen headless-native integration path), en je afhankelijkheid van developers wordt permanent.

Voor Shopify Plus brands die wel headless gaan, blijven Hydrogen en Oxygen de aanbevolen stack. Hydrogen is gebouwd op React Router, ondersteunt Storefront API 2026-04 met huidige functies en levert codemods in lijn met Shopify's eigen API cadence. Als je team diep Next.js expertise heeft, is dat pad nog steeds haalbaar, maar je bent volledig verantwoordelijk voor de Storefront API integratie en Oxygen hosting is niet beschikbaar.

De Praktische Checklist

Dit is wat je deze maand moet doen:

1. Controleer je huidige API-versie. Documenteer elke plek waar je een versie string hardcodes. Als je op 2024-10 bent, heb je tot oktober. Begin nu met testen tegen 2026-07 in staging.
2. Migreer onmiddellijk weg van Shopify Scripts. De 30 juni deadline is vast. Ga naar Shopify Functions.
3. Test je Storefront MCP endpoint op een dev store. Voer een echte product search uit en lees precies wat een AI agent ziet. Ontbrekende policy pagina's, dunne product beschrijvingen en onduidelijke variant naming worden nu aan agents getoond. Ze repareren is sneller en impactvoller dan de meeste roadmap functies.
4. Onderteken bot requests met Web Bot Auth als je ander automated tooling tegen de Storefront API draait.
5. Voeg cart warning handlers toe voor PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION en DELIVERY_SELECTED_OPTION_NOT_AVAILABLE voor je upgrade naar 2026-07.

De stores die in 2026 achterblijven zullen niet de stores zijn die het verkeerde framework kozen. Het zullen de stores zijn die de changelog tot oktober negeerden.