QA-sjekkliste for Shopify-metafields før API 2026-10

Shopify-metafields lar butikker og apper lagre egendefinerte data på Shopify-ressurser som produkter, kunder og bestillinger. De kan brukes til produktinformasjon, merknader om oppfyllelse, relasjoner mellom relaterte produkter, automatiseringer i Shopify Flow og backend-prosesser.

Etter hvert som metafields blir en del av mer butikklikk og flere integrasjoner, blir riktig konfigurasjon viktigere, spesielt når applikasjoner bruker dem i API-spørringer.

En viktig endring kommer med Shopifys Admin GraphQL API-versjon 2026-10, planlagt for 1. oktober 2026. Fra og med denne versjonen vil en spørring som filtrerer på et metafield som ikke er riktig satt opp for filtrering, returnere en feil. Tidligere kunne Shopify stille ignorere det ugyldige predikatet og returnere misvisende resultater. Shopify kunngjorde endringen i utviklerloggen sin 24. juli 2026 developer changelog. 

For utviklere som vedlikeholder Shopify-apper eller skreddersydde integrasjoner, gir dette en tydelig grunn til å gjennomgå metafield-definisjoner og filtrerte GraphQL-spørringer før oppgradering til 2026-10.

Hva endres i Shopify API-versjon 2026-10

Fra API-versjon 2026-10 validerer GraphQL Admin API metafield-filtre før en spørring kjøres. Ifølge Shopify mislykkes et metafield-filter ofte når:

• metafieldet ikke har en definisjon;
• metafield-definisjonen ikke er konfigurert til å tillate filtrering;
• metafield-typen ikke støtter filteret eller sammenligningen som brukes.

Tidligere kunne et ugyldig metafield-predikat bli ignorert. Det betydde at en spørring kunne se ut til å fungere, samtidig som den returnerte resultater som ikke samsvarte med det tiltenkte filteret. Med 2026-10 returnerer Shopify i stedet en feil som forklarer filtreringsproblemet. Endringen påvirker apper og integrasjoner som filtrerer ressurser etter metafields via GraphQL Admin API på 2026-10 eller nyere. Spørringer som bruker 2026-07 og eldre, beholder den tidligere oppførselen til de oppgraderes.

Spørringer som bruker metafields som er riktig konfigurert for filtrering, sammen med støttede sammenligninger, skal fortsette å fungere som før.

Hvorfor metafield-definisjoner er viktige

En metafield-definisjon fastsetter strukturen og reglene for metafields som deler et bestemt namespace og en bestemt nøkkel. Definisjoner kan angi egenskaper som:

• datatype
• valideringsregler
• tilgangsinnstillinger
• støttede funksjoner

Shopify har egen dokumentasjon for administrasjon av disse definisjonene.

For filtrering er én funksjon spesielt viktig: adminFilterable. Når den er aktivert for en støttet definisjon, gjør adminFilterable det mulig å bruke metafield-verdier ved filtrering av støttede ressurstyper i Shopify Admin og GraphQL Admin API.

Shopify oppgir for øyeblikket støtte for:

• Produkter
• Selskaper
• Selskapslokasjoner
• Metaobjects
• Bestillinger

Det finnes ytterligere begrensninger avhengig av ressurs og metafield-type. Shopify opplyser for eksempel at Admin Filterable ikke er tilgjengelig for JSON- eller rich text-metafields. Det betyr at bare det at et metafield finnes, ikke garanterer at det kan brukes i et GraphQL-filter. Et gyldig filtreringsoppsett avhenger av definisjonen, funksjonene den støtter, metafield-typen og sammenligningen som brukes i spørringen.

Andre nylige Shopify-endringer bygger også på metafield-definisjoner

Filtreringsoppdateringen i 2026-10 er ikke den eneste nylige Shopify-endringen som gjør metafield-definisjoner relevante.

Tilgang via Customer Account API

16. juni 2026 endret Shopify hvordan enkelte metafields kan nås via Customer Account API. Metafields lagret på app resource må nå ha en metafield-definisjon og riktige tillatelser for kundekonto for å være tilgjengelige via API-et.

Shopify anbefaler utviklere med apper som er avhengige av disse feltene i customer account UI extensions, Hydrogen eller headless-butikker, å sikre at metafields har definisjoner og riktige tilgangsinnstillinger.

Viktig å merke seg er at Shopify opplyser at metafields eid av Customer- eller Order-ressurser ikke påvirkes av denne konkrete endringen.

Metafield-endringer kan brukes i Shopify Events

Shopify utvidet også utviklerforhåndsvisningen av Events i juli 2026. Apper kan abonnere på målrettede metafield-endringer på ressurser som blant annet:

• Produkt
• Bestilling
• Kunde
• Samling
• Lokasjon

Dette kan gjøre det mulig for en app å reagere på en spesifikk endring i egendefinerte data i stedet for å abonnere på alle generelle ressursoppdateringer og sammenligne de resulterende payloadene. Denne funksjonaliteten bør imidlertid ennå ikke behandles som en stabil API-funksjon for produksjon. Shopifys nåværende eksempler konfigurerer Events med: api_version = "unstable"
Events-funksjonaliteten som omtales her er derfor fortsatt knyttet til Shopifys developer preview-/unstable-API-miljø.

Samlet viser disse endringene hvorfor utviklere bør vite hvilke metafields applikasjonene deres er avhengige av, hvordan de er definert, og hvor de brukes.

QA-sjekkliste for Shopify-metafields før 2026-10

Før du oppgraderer berørte integrasjoner til API 2026-10, bør du gå gjennom metafields som brukes i GraphQL-filtrering og bekrefte at de er riktig konfigurert.

1. Finn GraphQL-spørringer som filtrerer på metafields
   Identifiser spørringer i appene og integrasjonene dine som bruker metafields som filter i GraphQL Admin API.
2. Bekreft metafield-definisjoner
   Sjekk at hvert metafield som brukes til filtrering, har en passende definisjon med riktig owner type, namespace, key og datatype.
3. Kontroller filtreringsfunksjoner og felttyper
   Bekreft at adminFilterable er aktivert der det kreves, og at metafield-typen støtter filteret eller sammenligningen som brukes i spørringen.
4. Test spørringer mot API 2026-10
   Kjør berørte spørringer med API-versjon 2026-10 og bekreft at de returnerer forventede resultater uten feil knyttet til metafield-filtrering. Shopify anbefaler spesifikt å teste spørringer som filtrerer på metafields før oppgradering.
5. Gå gjennom relaterte API-avhengigheter
   Hvis implementasjonen din bruker metafields på app-resource via Customer Account API, må du bekrefte at nødvendige definisjoner og tilgangsinnstillinger er på plass. Hvis du bruker Shopify Events, bør du også gå gjennom arbeidsflyter som reagerer på metafield-endringer. Merk at denne Events-funksjonaliteten for øyeblikket bruker Shopifys unstable-API-versjon.
6. Dokumenter eierskap og eldre felt
   Noter hvilken app, integrasjon eller hvilket team som har ansvar for viktige metafields. Identifiser også dupliserte eller eldre felt før du gjør endringer i skjemaet. Dette er ikke et krav som innføres av API 2026-10, men det kan gjøre metafield-avhengigheter enklere å vedlikeholde og revidere.

Ikke vent til API-oppgraderingen med å finne ugyldige filtre

Fra og med Admin GraphQL API-versjon 2026-10 vil ugyldige metafield-filtre gi feil i stedet for å bli ignorert i stillhet. Før du oppgraderer, bør du gå gjennom metafields integrasjonene dine bruker til filtrering, bekrefte at definisjonene og filtreringsfunksjonene deres er riktig konfigurert, og teste berørte spørringer mot 2026-10.

Ytterligere kontroller, som å dokumentere eierskap eller gå gjennom eldre felt, er nyttige beste praksiser, men er ikke nye krav som innføres med denne API-versjonen.

QA-sjekkliste for Shopify-metafields

Bruk denne korte sjekklisten før du oppgraderer berørte integrasjoner:

• Finn GraphQL Admin API-spørringer som filtrerer på metafields.
• Noter owner type, namespace, key og type for hvert berørt metafield.
• Bekreft at hvert filtrert metafield har en definisjon.
• Bekreft at definisjonen tillater filtrering.
• Bekreft at metafield-typen støtter filteret eller sammenligningen som brukes.
• Rett opp ugyldige metafield-filtre.
• Test berørte spørringer mot API 2026-10.
• Bekreft at forventede ressurser returneres etter filtrering.
• Gå gjennom relevante avhengigheter til Customer Account API separat.
• Dokumenter eierskap til metafields der flere systemer er avhengige av samme felt.
• Gå gjennom eldre eller dupliserte egendefinerte felt før du gjør endringer i skjemaet.

Oppsummering

Shopify API 2026-10 gjør metafield-filtrering strengere, så dette er et godt tidspunkt å gå gjennom de egendefinerte dataene appene og integrasjonene dine er avhengige av.

Før du oppgraderer, må du sørge for at filtrerte metafields har gyldige definisjoner, at nødvendige filtreringsfunksjoner er aktivert, og at berørte GraphQL-spørringer er testet mot den nye API-versjonen. En kort metafield-revisjon nå kan bidra til å forhindre unødvendige feil når 2026-10 lanseres 1. oktober 2026.