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:
- cer o cheie într-un caz diferit de cel în care e stocată cheia pe market;
- piețele cumpărătorului stochează aceeași cheie în cazuri diferite.
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:
- 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.
- Citești metafield-uri pe Market prin
Market.metafields, sau doar prinMarket.metafield? Dacă folosești doarMarket.metafield, sursa spune explicit că nu ești afectat. - 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:
- Inventar. Listează toate locurile din cod în care apare
Market.metafields. Include storefront-ul, aplicațiile custom și orice script de integrare. - Test comparativ. Rulează interogarea de comparație pentru fiecare cheie folosită, cu contextul de țară relevant. Sursa dă exemplul cu
@inContext(country: CA), adaptează-l la piețele tale. - Decizie pe fiecare diferență. Pentru fiecare cheie unde rezultatele diferă, întreabă: afectează ce vede cumpărătorul sau doar un log intern? Dacă doar un log, poți accepta schimbarea. Dacă afectează storefront-ul, corectează.
- Standardizează cazul cheilor. Alege un singur caz pentru fiecare cheie și aplică-l pe toate piețele. Asta elimină și a doua condiție de risc din sursă, cea cu piețele care stochează aceeași cheie în cazuri diferite.
- Programează migrarea. Nu lăsa trecerea la 2027-01 pe ultima zi. Testează pe un mediu de staging unde poți rula versiunea nouă fără să atingi producția.
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:
- Nu știm dacă există și alte obiecte cu comportament similar care se schimbă în 2027-01. Anunțul vorbește doar despre Market.
- Nu știm ce se întâmplă când două piețe stochează aceeași cheie în cazuri diferite și ambele sunt relevante pentru cumpărător. Sursa recomandă să nu depinzi de cazul cheilor, ceea ce e o soluție de bun simț, dar nu e o specificație completă de comportament.
- Nu știm dacă există un termen recomandat de migrare dincolo de versiunea de API. Sursa spune doar să revizuiești interogările înainte de a muta aplicația pe 2027-01.
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ă.
Comentarii
Ca sa lasi un comentariu, conecteaza-te sau fa-ti un cont gratuit.
Niciun comentariu inca. Fii primul.