Mage-OS 4.0 kwam op 30 oktober uit, gebaseerd op Magento Open Source 2.4.9. Tot nu toe was Mage-OS vooral dezelfde code als Adobe’s Magento Open Source, met snellere security-releases als grootste verschil. Met 4.0 verandert dat. Er komt eigen functionaliteit bij die Magento Open Source niet heeft, en die functionaliteit grijpt in op plekken waar je nu waarschijnlijk al een extensie hebt draaien.
Dat maakt deze release interessanter dan de vorige, en ook iets om niet zomaar even tussendoor te installeren.
Wat er nieuw is
Voor vindbaarheid zit er het meeste in. Een nieuwe SEO-module levert JSON-LD voor producten, je organisatie en breadcrumbs (met templates voor zestien producttypen), plus Open Graph, Twitter cards en hreflang voor multistore-shops. Daarnaast is er een stap richting AI-zoekmachines: /llms.txt, /llms-full.txt en /llms.jsonl, met instellingen voor veertien bekende AI-crawlers. Er komt ook een FAQ-manager met widget, Page Builder-integratie en FAQPage-markup.
Voor inloggen komen passkeys (WebAuthn/FIDO2) voor klanten, via REST en GraphQL, op zowel Luma als Hyvä. In de admin kun je passkeys beheren en intrekken, en beheerders kunnen een passkey als tweede factor gebruiken. Vereist wel HTTPS, wat op een fatsoenlijke productieomgeving geen probleem zou moeten zijn.
Voor voorraad is er een overhaul van MSI: reserveringen per source, detectie van oversell, reconciliatie-tools en een Stock Visualizer om te zien wat waar staat.
En in de admin zelf komt Mago, een AI-assistent waaraan je in gewone taal vragen kunt stellen en die met jouw bevestiging ook wijzigingen kan doorvoeren. Je koppelt je eigen account bij een LLM-aanbieder; op dit moment zijn dat Claude (Anthropic) en OpenAI. Andere aanbieders en self-hosted modellen zijn er nog niet, al is Mago open source en kun je daar zelf aan bijdragen. Mago is gebouwd door vijf Nederlandse bureaus, en Linted is daar een van de initiatiefnemers van. Hoe dat zo kwam en wat Mago precies doet, staat in Mago: de AI-assistent die we met vijf bureaus bouwden.
Verder, minder zichtbaar maar wel relevant: native productfeeds voor onder meer Google Shopping, Meta, Pinterest, TikTok en Microsoft Merchant Center, een extensieoverzicht met ongeveer 1.100 open-source modules, en onder de motorkap native WebP- en AVIF-ondersteuning, een snellere setup:di:compile en caching van GraphQL-klantresponses per website.
Wat je moet weten voordat je upgradet
Het belangrijkste risico zit niet in de nieuwe code zelf, maar in wat je al hebt draaien. De SEO-module vervangt mage-os/module-meta-robots-tag en mage-os/module-hreflang, en die moet je vóór de upgrade verwijderen met composer remove mage-os/module-meta-robots-tag mage-os/module-hreflang --no-update. Heb je daarnaast een losse SEO-extensie voor structured data of hreflang, dan is dubbele JSON-LD op je pagina’s een reëel risico: zoekmachines krijgen dan twee keer dezelfde informatie, in net iets andere vorm, en dat is nooit een verbetering.
De MSI-wijzigingen raken alles wat met voorraad te maken heeft, inclusief koppelingen met een ERP of voorraadsysteem. Reserveringen en oversell-detectie werken anders dan voorheen, en als je voorraad via een externe koppeling binnenkomt, wil je weten of die koppeling daar goed mee overweg kan vóórdat je live gaat.
Voor de nieuwe llms.txt-bestanden en SEO-feeds moeten queue consumers via cron draaien, en vul je onder Marketing > SEO de gegevens van je organisatie in. Zonder die stappen werkt de functionaliteit niet of half.
Test dit op staging, niet op productie. En als je niet zeker weet of je huidige extensies compatibel zijn of elkaar in de weg zitten, is dat precies waar een code review voor is.
De AI-assistent: nuchter bekeken
Mago is het meest besproken onderdeel van deze release, en ook het onderdeel waar je het meest bewust mee moet omgaan. We zijn hier niet neutraal: Linted bouwde Mago mee, en de privacylaag is door ons gemaakt. Juist daarom het eerlijke verhaal.
Je kiest zelf een LLM-aanbieder, en productdata, bedragen en instellingen gaan naar die partij. Namen, e-mailadressen, telefoonnummers en adressen van klanten niet: Mago vervangt die door codes voordat er iets verstuurd wordt, en vult ze pas op jouw scherm weer in. Dat staat altijd aan en kan niet uit. Maar omdat je winkel weet welke code bij welke klant hoort, blijft het onder de AVG vallen. Je hebt dus nog steeds een verwerkersovereenkomst met je aanbieder nodig. En weet je zeker dat de bevestigingsdialoog voor wijzigingen ook echt in je workflow past, en niet een stap wordt die iedereen na een paar weken blind wegklikt?
Wil je je data liever helemaal niet bij een externe partij hebben, dan is een self-hosted model de logische route, maar die koppeling bestaat nog niet. Zet de assistent in elk geval niet zomaar aan omdat hij er is. Bepaal eerst wat hij voor jouw team oplevert, en wat hij kost aan data die de deur uitgaat.
Moet je upgraden?
Draai je al op Mage-OS 3.x: ja, plan dit in. Met 4.0 is 3.6.0 end of life. Die release van 14 oktober bevatte de fix voor CVE-2026-103849, het lek dat Sansec BlockStrap noemde: template injection zonder in te loggen, met remote code execution als gevolg en de maximale CVSS-score van 10.0. Mage-OS riep elke 3.x-installatie op die release te installeren. Komt er een volgend lek, dan krijgt een lijn zonder support die fix niet meer.
Plan de upgrade zelf niet vlak voor Black Friday op 27 november. Doe het na de piek, met genoeg tijd voor staging en voor het oplossen van de extensie-conflicten die je er mogelijk tegenkomt. Zie ook hoe je een shop op Black Friday voorbereidt als die datum nog op je bord ligt.
Draai je nog op Magento Open Source van Adobe: dan is 4.0 niet zomaar een patch, maar een overstap naar een distributie die inhoudelijk afwijkt. Of dat voor jou de juiste keuze is, hangt af van wat je nodig hebt en wat je al aan extensies hebt opgebouwd. Die afweging staat uitgebreider in Adobe Commerce versus Mage-OS.
De upgrade zelf verloopt via composer:
composer require mage-os/product-community-edition=^4.0 --no-update
composer update
bin/magento setup:upgradeSimpel qua commando’s, maar de voorbereiding (extensies verwijderen, staging testen, cron en organisatiegegevens instellen) is waar het werk zit.
Hoe wij het doen
Bij shops die bij ons in Magento onderhoud zitten, kijken we eerst welke extensies conflicteren met de nieuwe SEO-module en MSI-wijzigingen, testen we de upgrade op staging, en nemen we pas daarna een besluit over de AI-assistent. Neem contact op als je wilt weten wat deze release voor jouw shop betekent.
Veelgestelde vragen
Is Mage-OS 4.0 hetzelfde als Magento Open Source 2.4.9?
Nee, niet meer volledig. Mage-OS 4.0 is gebaseerd op Magento Open Source 2.4.9, maar voegt eigen functionaliteit toe die in Adobe’s versie niet zit, zoals de SEO-module, passkeys, de FAQ-manager en de AI-assistent Mago.
Moet ik mijn huidige SEO-extensie verwijderen?
Alleen de modules module-meta-robots-tag en module-hreflang moet je vóór de upgrade verwijderen met composer remove, omdat de nieuwe SEO-module die vervangt. Heb je een losse SEO-extensie van een andere partij voor structured data, check dan eerst of die niet dubbele JSON-LD gaat opleveren.
Moet ik de AI-assistent Mago aanzetten?
Niet verplicht, en niet iets om zomaar aan te zetten. Productdata en bedragen gaan naar de LLM-aanbieder die je kiest; persoonsgegevens van klanten vervangt Mago door codes. Regel eerst een verwerkersovereenkomst en bepaal wie in je team het gebruikt en waarvoor, voordat je de assistent inschakelt.
Welke PHP-versies ondersteunt Mage-OS 4.0?
Dezelfde als 3.6.0: PHP 8.3 tot en met 8.5. Er is op dit punt niets veranderd ten opzichte van de vorige lijn.