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

Als je op een Storefront API-versie van 2024 bent blijven hangen, tikt de klok. Shopify's platform beweegt snel in 2026, en de veranderingen dit seizoen zijn groter dan de gebruikelijke driemaandelijkse opschoning. Hier volgt een nuchter overzicht van wat er aankomt, wat breekt, en waar de echte kans ligt.

Storefront API 2026-07: Wat Breekt Voor Oktober

Shopify's Summer 2026 Edition (codenaam 'Compass') brengt 65 product updates met zich mee, en de Storefront API 2026-07 release candidate is waar developers zich op moeten concentreren. Het introduceert breaking changes aan cart- en product query-structuren die elke headless-build raken, of je nu op Hydrogen, Next.js Commerce, Nuxt of een custom stack zit. De oude API-versie 2024-10 wordt in oktober 2026 stopgezet, waardoor teams vijf maanden hebben om te migreren.

Twee veranderingen verdienen bijzondere aandacht:

• PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION waarschuwing. Vanaf 2026-07 geeft het Cart object een PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION waarschuwing af wanneer een cart line een product bevat dat niet beschikbaar is op de locatie van de koper. Elke betreffende cart line retourneert zijn eigen waarschuwing, met een target ingesteld op de Cart Line ID zodat je het in je UI kunt mappen. Als je over meerdere markten verkoopt, moet je frontend deze waarschuwingen elegant verwerken in plaats van producten stilzwijgend te verbergen.
• DELIVERY_SELECTED_OPTION_NOT_AVAILABLE waarschuwing. Eerder zou het systeem automatisch overschakelen naar een ander leveringsoptie zonder iemand te waarschuwen als de gekozen optie van de koper niet meer beschikbaar was (na cartadres of inhoudwijzigingen). Versie 2026-07 geeft nu een DELIVERY_SELECTED_OPTION_NOT_AVAILABLE waarschuwing af zodat je kopers kunt vragen een nieuwe optie te bevestigen of kiezen.

Voor Hydrogen-gebruikers levert Shopify codemods die de meeste structurele veldwijzigingen aanpakken. Ze zullen aangepaste kortingslogica niet oplossen, dus als je winkel gelaagde prijsstelling, BOGO-regels of marktspecifieke kortingen heeft, is die migratie voor jou.

Ook het vermelden waard: de enums PRIVATE en PUBLIC_READ voor metaobjecten worden in 2026-07 verwijderd. Vervang die voor 1 juli als je ze gebruikt.

Shopify Scripts Is Weg. Echt Dit Keer.

Dit is al jaren aangekondigd, maar de deadline is nu echt. Vanaf 15 april 2026 kun je Shopify Scripts niet meer maken, bewerken of publiceren. Na 30 juni 2026 worden Scripts helemaal niet meer uitgevoerd. Als je winkel nog steeds op Ruby-gebaseerde Scripts vertrouwt voor aangepaste kortingen, line item-regels of verzendlogica, is het migratiepad Shopify Functions of een openbare app. Er is geen uitstel op deze deadline.

Verbeterde Auth-flows Voor Headless Checkouts

Een rustigere maar belangrijke update van de recente changelog: verbeterde verificatieflows van cart naar checkout ondersteunen nu opgeslagen kaarten en winkeltegoeden, wat de koopervaring speciaal voor headless storefronts verbetert. Dit sluit een gat dat jarenlang wrijving in headless-builds heeft veroorzaakt, waarbij authenticated checkout-functies achterbleven bij de standaard Liquid-gebaseerde ervaring.

Aanverwant: de GraphQL Admin API bevat nu een cartToken veld op het Order object, waardoor developers het cart token kunnen openen dat gebruikt is om een bestelling te maken. Dit maakt het gemakkelijker om de volledige funnel te traceren van een headless cartsessie door naar het fulfillment-record.

Agentic Commerce Is Geen Toekomsttrend. Het Draait Al.

Dit is de grootste architecturale verschuiving die nu begrijpen waard is, en het herschrijft enkele aannames over wat headless eigenlijk betekent.

Op 11 januari 2026 kondigde Shopify zijn agentic commerce-platform aan, gebouwd op drie pijlers: het Universal Commerce Protocol (UCP), een open standaard in samenwerking met Google; per-winkel Storefront MCP servers; en een Agentic Plan voor merken die nog niet op Shopify zijn. Eind maart 2026 activeerde Shopify Agentic Storefronts standaard voor elke winkel op het platform. Je producten worden al syndicated via de Shopify Catalog tenzij je je hebt afgemeld.

De getallen hierachter zijn significant. Sinds januari 2025 is door AI aangedreven verkeer naar Shopify-winkels 8 keer per jaar gestegen, terwijl bestellingen van door AI aangewaaide zoekopdrachten 15 keer zijn gegroeid. Shopify merchants zijn nu terug te vinden in ChatGPT, Microsoft Copilot, AI Mode in Google Search en de Gemini-app.

UCP wordt in samenwerking met Google ontwikkeld en ondersteund door Amazon, American Express, Etsy, Mastercard, Meta, Microsoft, Salesforce, Stripe, Target, Walmart en Visa. Wanneer een nieuw AI-platform UCP aanneemt, zijn Shopify merchants automatisch klaar om daar zonder aanvullende integratie te verkopen. Het protocol bestrijkt het maken van carts, checkout, betaling en na-aankoop via elk platform en betaalsysteem.

Op 22 april 2026 keerde Shopify ook de Storefront Catalog MCP server om UCP te implementeren. Als je een aangepaste AI agent-integratie op een Hydrogen storefront hebt gebouwd, zijn de oude tool names en endpoint verouderd, met de nieuwe versies geldend vanaf 30 mei en oude versies stopgezet op 15 juni.

Wat Dit Betekent Voor Headless-architectuur

Hier wordt het gesprek interessant. Het klassieke argument voor headless was: ontkoppel alles voor maximale flexibiliteit. Dit argument heeft nog steeds waarde voor prestaties en designcontrole. Maar er is nu een tegenargument dat commercieel van belang is.

AI agents (ChatGPT, Gemini, Copilot) lezen gestructureerde catalogusgegevens en plaatsen bestellingen zonder je CSS of aangepaste frontend ooit te laden. Als je headless stack buiten Shopify's catalogus graph leeft, 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 plaatst.

Rate Limits: Bots en Agents Nu Anders Behandeld

Shopify past nu strengere rate limits toe op bots en agents die de Storefront API en door Shopify gehoste online store-pagina's openen. Bots en agents die hun verzoeken niet ondertekenen, zijn onderhevig aan de strengste limieten. Om in aanmerking te komen voor hogere rate limits, moeten operators verzoeken ondertekenen met Web Bot Auth. Als je crawlers, AI agents of geautomatiseerde tools tegen je storefront uitvoert, registreer je nu en onderteken je verzoeken.

Wie Moet Echt Headless Gaan in 2026?

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 waarbij verbeteringen van prestaties een meetbaar effect op inkomsten hebben, in-house JavaScript developers of een langetermijnpartner van een bureau met Hydrogen-ervaring, content-commerce hybridewinkels waarbij redactionele content en productpagina's diep geïntegreerd zijn.
• Sla het nu over: Nieuwe winkels onder 1 miljoen dollar. Beheers je Liquid theme eerst. Het prestatieplafond van een goed geoptimaliseerde Hydrogen-build is hoger, maar de kosten bedragen ongeveer 3 tot 5 keer die van een traditionele build, app-compatibiliteit vereist actieve re-engineering (veel middelgrote apps in de Shopify App Store bieden nog steeds geen headless-native integratiepad per 2026), en je afhankelijkheid van developers wordt permanent.

Voor Shopify Plus merken die headless gaan, blijven Hydrogen en Oxygen de aanbevolen stack. Hydrogen is gebouwd op React Router, ondersteunt Storefront API 2026-04 met huidige functies, en biedt codemods afgestemd op Shopify's API-cadence. Als je team diepe Next.js-expertise heeft, is dat pad nog steeds levensvatbaar, maar je bezit de Storefront API integratie volledig en Oxygen hosting is niet beschikbaar.

De Praktische Checklist

Dit kun je deze maand doen:

1. Controleer je huidige API-versie. Documenteer elke plaats waar je een versietekenreeks hardcoded. Als je op 2024-10 bent, heb je tot oktober. Begin nu tegen 2026-07 te testen in staging.
2. Migreer onmiddellijk weg van Shopify Scripts. De deadline van 30 juni is stellig. Ga naar Shopify Functions.
3. Test je Storefront MCP endpoint op een dev store. Voer een echte productzoeking uit en lees precies wat een AI agent ziet. Missende beleidspagina's, dunne productbeschrijvingen en onduidelijke variantnamen worden nu aan agents getoond. Ze repareren is sneller en heeft meer impact dan de meeste roadmap-functies.
4. Onderteken botverzoeken met Web Bot Auth als je geautomatiseerde tools tegen de Storefront API uitvoert.
5. Voeg cart warning handlers toe voor PRODUCT_UNAVAILABLE_IN_BUYER_LOCATION en DELIVERY_SELECTED_OPTION_NOT_AVAILABLE voordat je naar 2026-07 upgradet.

De winkels die in 2026 achterliggen zullen niet degenen zijn die voor het verkeerde framework hebben gekozen. Het zullen degenen zijn die de changelog tot oktober hebben genegeerd.