Din versiunea 2027-01 a Storefront API, câmpul Market.metafields returnează metafield-ul și când cheia cerută diferă la majuscule/minuscule față de cea stocată, la fel ca Market.metafield. Este o schimbare care poate rupe storefront-uri și aplicații care se bazau pe potrivirea exactă a cazului. Dacă magazinul tău citește metafield-uri pe obiectul Market, trebuie să verifici înainte de migrare.

Anunțul vine de la Shopify Changelog, cu data de 13.11.2026, iar subiectul e cât se poate de concret pentru echipele de comerț online care au storefront-uri custom sau aplicații care interoghează metafield-uri pe Market, prin Localization.market sau Country.market. Nu e o schimbare de marketing în sensul de reclame, dar e o schimbare de infrastructură a datelor de magazin care afectează exact zona în care marketerii citesc diferențieri pe piețe. Merită tratată cu seriozitate, pentru că e marcată drept breaking change.

Ce s-a schimbat, concret

Până la versiunea 2026-10 inclusiv, Market.metafields returna un metafield doar dacă cheia cerută și cheia stocată aveau exact același caz. Dacă în magazin exista cheia colour în namespace-ul custom și aplicația cerea Colour, rezultatul era null. Din 2027-01, aceeași cerere returnează metafield-ul stocat.

Asta aliniază comportamentul lui Market.metafields cu Market.metafield, care potrivea deja cheile fără sensibilitate la caz. În practică, înainte de 2027-01, cele două câmpuri puteau da rezultate diferite pentru aceeași cheie: Market.metafield găsea metafield-ul, Market.metafields returna null. Din 2027-01, ambele returnează același metafield, deci storefront-ul afișează aceeași valoare indiferent pe care câmp îl interoghează.

Versiunile 2026-10 și anterioare nu se schimbă. Cine nu migrează rămâne pe comportamentul vechi, cu riscurile aferente de inconsistență între cele două câmpuri.

Cine e afectat și cine nu

Conform sursei, schimbarea se aplică aplicațiilor și storefront-urilor custom care interoghează metafield-uri pe obiectul Market, din Localization.market sau Country.market, cu versiunea 2027-01 sau mai nouă. Sunt afectate doar cele care îndeplinesc una din două condiții:

Nu sunt afectate aplicațiile care cer fiecare cheie exact în cazul în care e stocată pe market, sau care folosesc doar Market.metafield, care potrivea deja cheile fără sensibilitate la caz.

Aici e un detaliu care merită subliniat pentru echipele care lucrează cu mai multe piețe: a doua condiție e cea care scapă neobservată. Dacă ai un market pentru România, unul pentru Bulgaria și unul pentru Polonia, iar un operator a introdus cheia colour într-un market și Colour în altul, aplicația poate primi rezultate diferite în funcție de piață, fără ca nimeni să fi modificat codul. După 2027-01, comportamentul se unifică, dar diferențele de date rămân în configuratie.

De ce contează pentru un storefront care vinde pe mai multe piețe

Metafield-urile pe Market sunt exact locul în care stochezi diferențieri pe piață: texte legale, condiții de livrare, mesaje locale, poate chiar variante de preț sau de disponibilitate afișate condiționat. Dacă storefront-ul tău citește aceste date și logica depinde de faptul că o cheie returnează null pe o piață, schimbarea din 2027-01 poate transforma un null într-o valoare. Nu e neapărat un dezastru, dar e o schimbare de comportament care trebuie cunoscută, nu descoperită în producție.

Sursa propune o metodă simplă de verificare: pentru fiecare metafield de market pe care aplicația îl citește, interoghează Market.metafield și Market.metafields cu același namespace și cheie, și compară rezultatele. Dacă rezultatele sunt identice pentru fiecare cheie, nu trebuie să faci modificări. Dacă diferă, verifică dacă diferența are impact material asupra aplicației sau a storefront-ului. Dacă da, actualizează aplicația și metafield-urile astfel încât să nu depindă de cazul cheilor.

Recomandarea mea, separată de materialul sursă: nu te opri la comparația din query. Notează rezultatul într-un tabel cu namespace, cheie, valoare pe Market.metafield, valoare pe Market.metafields și decizia luată. Un astfel de tabel e documentația pe care o cauți peste șase luni când cineva întreabă de ce s-a schimbat un text pe piața din Polonia.

Ce înseamnă pentru tine, ca antreprenor sau marketer în România

Dacă ai un magazin pe Shopify cu storefront standard și tema din marketplace, probabil nu ai nicio modificare de făcut. Tema citește metafield-urile prin mecanismele platformei, iar schimbarea e marcată pe versiunea de API 2027-01, nu pe versiunile pe care rulează acum magazinul.

Dacă ai un storefront headless, construit pe Hydrogen sau pe alt framework care consumă Storefront API, atunci ești exact în publicul vizat. Aici apar trei întrebări pe care ți le pui în ordine:

  1. Ce versiune de Storefront API folosește storefront-ul acum? Dacă e 2026-10 sau mai veche, schimbarea nu te atinge încă, dar te atinge la migrare.
  2. Citești metafield-uri pe Market prin Market.metafields, sau doar prin Market.metafield? Dacă folosești doar Market.metafield, sursa spune explicit că nu ești afectat.
  3. Ai chei scrise diferit între piețe? Verifică în admin, nu presupune că toți operatorii au scris la fel.

Pentru un marketer, miza nu e tehnică în primul rând, ci de consistență a mesajului pe piață. Dacă un metafield pe Market controlează un mesaj de livrare sau o condiție comercială, o schimbare de comportament în citirea lui se poate traduce într-un mesaj diferit afișat cumpărătorului. Nu e o catastrofă, dar e genul de detaliu care apare în sesiuni de reclamații și într-un audit de conversie.

Un alt aspect practic: dacă lucrezi cu o agenție sau cu un dezvoltator extern, pune întrebarea direct. Cere versiunea de API folosită și o listă a interogărilor Market.metafields. Nu accepta un răspuns de tipul „probabil nu ne afectează”. Sursa oferă un test clar, iar testul se poate rula.

Ce faci în practică, pas cu pas

Iată un plan de lucru pe care îl propun, distinct de instrucțiunile oficiale:

Un detaliu de disciplină: testează și cazul în care cheia nu există deloc pe o piață. Sursa vorbește despre potrivirea cheilor existente, nu despre comportamentul când cheia lipsește, iar aici e o zonă pe care nu o poți deduce din anunț. Dacă logica ta depinde de absența unei chei pe o piață, verifică separat, nu presupune.

Limitele anunțului și ce nu știm încă

Anunțul e scurt și precis, dar lasă câteva lucruri deschise, pe care nu le pot deduce din material:

Astea nu sunt motive de panică. Sunt motive de verificare. O verificare incompletă nu dovedește că nu ai o problemă, dovedește doar că nu ai căutat suficient.

Pentru context mai larg despre cum arată măsurarea curată pe un storefront, merită citit și materialul despre separarea mediilor custom în analytics la Vercel, unde logica e similară: datele se amestecă dacă nu separi mediile. Tot pe zona de măsurare și raportare, articolul despre facturare și raportare automatizate cu Prisma și Microsoft Ads arată cum arată un flux de date care nu depinde de coincidențe de configurare.

FAQ

Sunt afectat dacă folosesc doar Market.metafield, nu Market.metafields? Nu. Sursa spune explicit că Market.metafield potrivea deja cheile fără sensibilitate la caz, deci aplicațiile care folosesc doar acest câmp nu sunt afectate.

Ce versiune de Storefront API trebuie să folosesc ca să fiu sigur? Schimbarea se aplică din 2027-01. Versiunile 2026-10 și anterioare nu se schimbă. Verifică în documentația de versionare a Shopify ce versiune rulează storefront-ul tău acum.

Cum aflu rapid dacă am o diferență? Interoghează Market.metafield și Market.metafields cu același namespace și cheie, pe fiecare piață. Dacă rezultatele sunt identice, nu ai modificări de făcut. Dacă diferă, verifică impactul material înainte să schimbi ceva.

Arcul ALLSoft Agency

Unelte precum AI-ul ajută la analiză și planning: poți genera rapid un inventar de interogări, poți compara rezultate și poți structura un tabel de decizie. Dar decizia și execuția rămân umane. Un media buyer sau un dezvoltator care cunoaște storefront-ul știe ce metafield controlează ce mesaj pe ce piață, iar asta nu se deduce dintr-un output de model. Pasul concret îl face ALLSoft Agency, cu verificare pe date reale și cu separare clară între ce s-a măsurat și ce rămâne ipoteză.