WooCommerce 10.5 komt eraan: dit verandert er voor developers (performance, API, checkout en belasting)

WooCommerce 10.5 staat voor de deur en is er eentje waar je als developer echt even naar wilt kijken. Niet alleen vanwege wat UI- en bugfixes, maar vooral door een fundamentele wijziging in hoe orderdata richting de Analytics-tabellen gaat. Daarnaast zitten er API-advisories in (met mogelijk breaking impact voor extensies), plus een aantal performance-experimenten die duidelijk maken waar WooCommerce heen wil.

Releaseplanning (en hoe je nu al test)

Op maandag 12 januari 2026 is de Feature Freeze ingegaan. Vanaf dat moment draait de focus vooral op testen en stabiliseren richting de release.

• ✅ Feature Freeze – toegevoegd: 12 januari 2026
• ✅ WooCommerce 10.5 Beta 1 – released: 19 januari 2026
• ✅ WooCommerce 10.5 Beta 2 – released: 26 januari 2026
• ⏳ WooCommerce 10.5 final – gepland: 4 februari 2026

Wil je de beta’s testen, dan is het advies om de WooCommerce Beta Tester plugin te gebruiken. Daarmee kun je beta-versies van WooCommerce in een testomgeving installeren zonder handmatig met zip-bestanden te slepen.

Wat er nieuw is in WooCommerce 10.5 (de highlights)

1) Grote wijziging: Analytics-import van orders gaat van ‘per event’ naar batches

De grootste verandering in 10.5 zit in de manier waarop WooCommerce orderdata importeert naar de Analytics-tabellen. Tot nu toe werd bij praktisch ieder order-event een analytics import job gestart via ActionScheduler. Dat werkte asynchroon, maar op drukke shops leverde het in de praktijk enorme backlogs op (denk: 10.000+ actions). Het gevolg: zware performance-degradatie, database contention en een merkbaar tragere site.

In 10.5 schakelt WooCommerce standaard over naar Scheduled Imports: een batch-gewijze refresh van analytics data elke 12 uur, waarbij er 100 orders per batch verwerkt worden. Beide waarden zijn aanpasbaar via nieuwe filters:

• woocommerce_analytics_import_interval – bepaalt het interval van de scheduled import (default: 12 uur).
• woocommerce_analytics_regenerate_batch_size – bepaalt het aantal orders per batch (default: 100).

Belangrijk detail: met deze aanpak daalt het aantal scheduled actions drastisch en neemt de databasebelasting af. Tegelijkertijd krijgen shop owners meer zicht op de status, en blijft het mogelijk om imports handmatig te triggeren wanneer dat nodig is. (Zie PR #61603.)

2) Checkout block: betere verzendopties-UI (met thumbnails en packages) + fix voor Ship/Pickup sync

De shipping options in het Checkout block krijgen een UI-update: als er meerdere packages zijn (wat bijvoorbeeld vaker gebeurt bij subscription-producten), dan toont WooCommerce nu product thumbnails en gebruikt het bordered containers voor duidelijkere afbakening.

Daarnaast is er een bug opgelost waarbij verzendmethodes niet goed synchroniseerden als je wisselde tussen Ship en Pickup delivery options. (Zie PR #61625.)

3) Orders bekijken wordt robuuster bij legacy of corrupte tax data

WooCommerce 10.5 verbetert de betrouwbaarheid bij het openen/bekijken van orders waarin legacy of corrupte belastingdata zit. Concreet: in sommige oude of afwijkende situaties waren tax values opgeslagen als floats/strings in plaats van arrays. Dat kan leiden tot fouten of onverwacht gedrag in order detail-schermen en verwerking.

De fix voegt backward-compatible handling toe voor alle order item types (producten, shipping, fees), en probeert tax rate IDs slim af te leiden op basis van de ordercontext. Voor extensies en maatwerk is er een extra filter waarmee je eigen conversielogica kunt inpluggen:

• woocommerce_order_item_legacy_tax_conversion – filter voor custom conversie van legacy tax data.

(Zie PR #62271.)

4) Select2-styling wordt scoped zodat het niet meer ‘lekt’ naar andere plugins

WooCommerce laadt Select2-styles (Select2 is de bekende JS dropdown/autocomplete library) die in sommige admin-interfaces ook andere plugins kunnen raken. In 10.5 worden die styles scoped via :where(.woocommerce).

De keuze voor :where() is relevant: die pseudo-class houdt specificity op nul. Dat betekent dat bestaande custom overrides doorgaans blijven werken, terwijl je tegelijk voorkomt dat WooCommerce Select2-styling andere plugin-UI’s beïnvloedt. (Zie PR #61956.)

5) Nieuwe filter: woocommerce_shipping_tax_class voor dynamische shipping tax-berekening

Er komt een nieuwe filter bij: woocommerce_shipping_tax_class. Daarmee kun je de shipping tax rate dynamisch bepalen op basis van cart contents, klantdata en locatie.

Dit is vooral interessant voor complexere belastingregels, waaronder scenario’s zoals je die in Nederland kunt tegenkomen. Een voorbeeld dat expliciet genoemd wordt: shipping tax berekenen op basis van het ‘predominante’ (meest voorkomende/leidende) tax rate in de cart. (Zie PR #59512.)

API changes & developer advisories (hier kun je regressies verwachten)

Naast de feature-updates bevat 10.5 een aantal wijzigingen die al in aparte developer posts zijn uitgelicht. Hieronder de kernpunten, met de links naar de volledige advisories voor de details.

• WC REST API: betere decoding van special characters in product variation attributes. Volledige context: https://developer.woocommerce.com/2026/01/14/wc-rest-api-fixes-for-product-variation-attributes-with-special-characters-in-woocommerce-10-5/
• De AccessiblePrivateMethods trait wordt verwijderd. Deze zat in de Internal namespace (dus nadrukkelijk niet bedoeld voor public use), maar extensies die ‘m toch gebruiken kunnen hierdoor breken. Details: https://developer.woocommerce.com/2026/01/15/removal-of-the-accessibleprivatemethods-trait-in-woocommerce-10-5/
• Product permalinks gebaseerd op categorieën worden aangepast: WooCommerce gaat de diepste categorie prioriteren voor consistentere URLs en SEO, en dit raakt alleen specifieke permalink-structuren. Details: https://developer.woocommerce.com/2026/01/13/product-permalink-changes-coming-in-woocommerce-10-5/
• Op variable product pages wordt de Add to Cart-knop standaard disabled totdat het variation script volledig geladen is. Op trage verbindingen voorkom je zo dat gebruikers te vroeg klikken en submissions falen. Details: https://developer.woocommerce.com/2026/01/16/add-to-cart-button-disabled-by-default-in-variable-products-in-woocommerce-10-5/

Performance improvements (inclusief experimenten)

Experimentele REST API cache

WooCommerce 10.5 introduceert een nieuwe experimentele REST API cache die je op elk endpoint in de WC REST API kunt toepassen. Er is nog niet alle informatie gedeeld; volgens de aankondiging volgt meer uitleg (ook over testen) richting de 10.5 release.

Verbeteringen aan cached variation prices + utility class voor callbacks

Cached variation prices krijgen verbeteringen, en er komt een nieuwe utility class voor het werken met callbacks. Voor de volledige technische uitwerking: https://developer.woocommerce.com/2026/01/08/variation-prices-caching-improvements-in-woocommerce-10-5/

Experimentele Product Object Caching (per request)

Er wordt ook een experimentele Product Object Caching feature geïntroduceerd. Het idee: tijdens één request product instances cachen zodat je niet meerdere keren hetzelfde product opnieuw uit de database hoeft te laden. Dat kan vooral op drukke pagina’s met veel product-resolving (filters, loops, blocks) merkbaar schelen.

De implementatie zit in PR https://github.com/woocommerce/woocommerce/pull/62041 en er is een aparte uitlegpost met details: https://developer.woocommerce.com/2026/01/19/experimental-product-object-caching-in-woocommerce-10-5/

Product Filters: cache-data fix + transients cleanup update

Er is een performance-fix gedaan rondom de cache-data van Product Filters. In sommige gevallen werd die data niet goed gezet en geladen, wat ertoe kon leiden dat de database overspoeld werd met filter data cache. Dat is vooral een probleem bij stores met grote catalogi.

WooCommerce past ook de transients cleanup tool aan: wanneer die draait, wordt nu ook de filter data cache opgeschoond. Praktisch betekent dit: gebruiken klanten het Product Filters block en zien ze nog steeds performanceproblemen, dan kan dit de oorzaak zijn – en dan is het opschonen van WooCommerce transients de aangewezen oplossing. (Zie PR #62575.)

Changelog

De volledige changelog staat in de WooCommerce repository: https://github.com/woocommerce/woocommerce/blob/10.5.0-beta.1/plugins/woocommerce/readme.txt

Waar ik als developer op zou letten bij het testen

• Shops met veel order-events: check of de nieuwe Scheduled Imports je ActionScheduler-queue en database load merkbaar rustiger maakt (en of je eigen reporting/analytics hooks geen onverwachte timing aannames hebben).
• Checkout block met subscriptions/meerdere packages: verifieer de UX (thumbnails/containers) en test switchen tussen Ship en Pickup.
• Extensies die ooit ‘even snel’ iets uit Internal hebben gebruikt: zoek expliciet op AccessiblePrivateMethods en controleer je compatibiliteit.
• REST API consumers: test variation attributes met speciale tekens (encoding/decoding).
• Sites met custom permalink-structuren voor producten op basis van categorie: valideer dat URL’s nog overeenkomen met je SEO-setup (met name door de ‘deepest category’-prioriteit).
• Performance bij grote catalogi met Product Filters block: check of transients opschonen effect heeft, en of de cache zich netjes gedraagt na de fix.