QA-tjekliste til Shopify Metafields før API 2026-10

Shopify metafields gør det muligt for butikker og apps at gemme brugerdefinerede data på Shopify-ressourcer som produkter, kunder og ordrer. De kan bruges til produktinformation, fulfillment-noter, relationer mellem relaterede produkter, Shopify Flow-automatiseringer og backend-processer.

Efterhånden som metafields bliver en del af mere butiksløs logik og flere integrationer, bliver deres opsætning vigtigere, især når applikationer bruger dem i API-forespørgsler.

En vigtig ændring kommer med Shopifys Admin GraphQL API-version 2026-10, som er planlagt til 1. oktober 2026. Fra denne version vil en forespørgsel, der filtrerer på et metafield, som ikke er korrekt sat op til filtrering, returnere en fejl. Tidligere kunne Shopify ignorere det ugyldige filter stille og roligt og returnere misvisende resultater. Shopify annoncerede ændringen i sin developer changelog den 24. juli 2026. 

For udviklere, der vedligeholder Shopify-apps eller specialbyggede integrationer, er det en klar anledning til at gennemgå metafield-definitioner og filtrerede GraphQL-forespørgsler, før de opgraderer til 2026-10.

Hvad ændrer sig i Shopify API-version 2026-10

Fra API-version 2026-10 validerer GraphQL Admin API metafield-filtre, før en forespørgsel køres. Ifølge Shopify fejler et metafield-filter typisk, når:

• metafieldet ikke har en definition;
• metafield-definitionen ikke er konfigureret til at tillade filtrering;
• metafield-typen ikke understøtter det filter eller den sammenligning, der bruges.

Tidligere kunne et ugyldigt metafield-filter blive ignoreret. Det betød, at en forespørgsel kunne se ud til at virke, selv om resultaterne ikke afspejlede det tilsigtede filter. Med 2026-10 returnerer Shopify i stedet en fejl, der forklarer problemet med filtreringen. Ændringen påvirker apps og integrationer, der filtrerer ressourcer efter metafields via GraphQL Admin API på 2026-10 eller nyere. Forespørgsler, der bruger 2026-07 og tidligere, beholder den tidligere adfærd, indtil de opgraderes.

Forespørgsler, der bruger metafields, som er korrekt konfigureret til filtrering sammen med understøttede sammenligninger, bør fortsætte med at fungere som hidtil.

Hvorfor metafield-definitioner er vigtige

En metafield-definition fastlægger strukturen og reglerne for metafields, der deler et bestemt namespace og key. Definitioner kan angive egenskaber som:

• datatype
• valideringsregler
• adgangsindstillinger
• understøttede capabilities

Shopify har særskilt dokumentation til håndtering af disse definitioner.

Når det gælder filtrering, er én capability særligt vigtig: adminFilterable. Når den er aktiveret for en understøttet definition, gør adminFilterable det muligt at bruge metafield-værdier til filtrering af understøttede ressourcetyper i Shopify Admin og GraphQL Admin API.

Shopify angiver i øjeblikket understøttelse for:

• Produkter
• Virksomheder
• Virksomhedslokationer
• Metaobjects
• Ordrer

Der er yderligere begrænsninger afhængigt af ressource og metafield-type. Shopify oplyser for eksempel, at Admin Filterable ikke er tilgængelig for JSON- eller rich text-metafields. Det betyder, at eksistensen af et metafield alene ikke garanterer, at det kan bruges i et GraphQL-filter. En gyldig filtreringsopsætning afhænger af definitionen, dens capabilities, metafield-typen og den sammenligning, der bruges i forespørgslen.

Andre nyere Shopify-ændringer bygger også på metafield-definitioner

Filtreringsopdateringen i 2026-10 er ikke den eneste nyere Shopify-ændring, der gør metafield-definitioner relevante.

Adgang via Customer Account API

Den 16. juni 2026 ændrede Shopify, hvordan visse metafields kan tilgås via Customer Account API. Metafields, der er gemt på app resource, skal nu have en metafield-definition og de rette tilladelser til customer account for at være tilgængelige via API'et.

Shopify anbefaler udviklere, hvis apps er afhængige af disse felter i customer account UI extensions, Hydrogen eller headless-butikker, at sikre, at metafields har definitioner og passende adgangsindstillinger.

Vigtigt er det, at Shopify oplyser, at metafields ejet af Customer- eller Order-ressourcer ikke er påvirket af denne specifikke ændring.

Metafield-ændringer kan bruges i Shopify Events

Shopify udvidede også sin developer preview for Events i juli 2026. Apps kan abonnere på målrettede ændringer i metafields på ressourcer som:

• Produkt
• Ordre
• Kunde
• Kollektion
• Lokation

Det kan gøre det muligt for en app at reagere på en specifik ændring i brugerdefinerede data i stedet for at abonnere på alle generelle opdateringer af en ressource og sammenligne de resulterende payloads. Denne funktionalitet bør dog endnu ikke betragtes som en stabil produktionsfunktion i API'et. Shopifys nuværende eksempler konfigurerer Events med: api_version = "unstable"
Events-funktionaliteten der henvises til her, er derfor stadig knyttet til Shopifys developer preview-/unstable-API-miljø.

Samlet set viser disse ændringer, hvorfor udviklere bør vide, hvilke metafields deres applikationer er afhængige af, hvordan de er defineret, og hvor de bliver brugt.

QA-tjekliste til Shopify Metafields før 2026-10

Før du opgraderer berørte integrationer til API 2026-10, bør du gennemgå de metafields, der bruges i GraphQL-filtrering, og bekræfte, at de er korrekt konfigureret.

1. Find GraphQL-forespørgsler med metafield-filtrering
   Identificér forespørgsler i dine apps og integrationer, der bruger metafields som filtre i GraphQL Admin API.
2. Bekræft metafield-definitioner
   Kontrollér, at hvert metafield, der bruges til filtrering, har en passende definition med korrekt owner type, namespace, key og datatype.
3. Tjek filtrerings-capabilities og felttyper
   Bekræft, at adminFilterable er aktiveret, hvor det kræves, og at metafield-typen understøtter det filter eller den sammenligning, der bruges i forespørgslen.
4. Test forespørgsler mod API 2026-10
   Kør de berørte forespørgsler med API-version 2026-10, og bekræft, at de returnerer de forventede resultater uden fejl i metafield-filtreringen. Shopify anbefaler specifikt at teste GraphQL-forespørgsler med metafield-filtrering før opgradering.
5. Gennemgå relaterede API-afhængigheder
   Hvis din løsning bruger app-resource-metafields via Customer Account API, skal du bekræfte, at de nødvendige definitioner og adgangsindstillinger er på plads. Hvis du bruger Shopify Events, bør du også gennemgå workflows, der reagerer på metafield-ændringer. Bemærk, at denne Events-funktionalitet i øjeblikket bruger Shopifys unstable-API-version.
6. Dokumentér ejerskab og legacy-felter
   Registrér, hvilken app, integration eller hvilket team der er ansvarligt for vigtige metafields. Identificér også duplikerede eller ældre felter, før du ændrer i schemaet. Dette er ikke et krav, der indføres med API 2026-10, men det kan gøre metafield-afhængigheder lettere at vedligeholde og auditere.

Vent ikke med at finde ugyldige filtre til API-opgraderingen

Fra og med Admin GraphQL API-version 2026-10 vil ugyldige metafield-filtre returnere fejl i stedet for at blive ignoreret uden varsel. Før du opgraderer, bør du gennemgå de metafields, dine integrationer bruger til filtrering, bekræfte at deres definitioner og filtrerings-capabilities er korrekt konfigureret, og teste de berørte forespørgsler mod 2026-10.

Yderligere kontroller, som at dokumentere ejerskab eller gennemgå legacy-felter, er nyttige best practices, men er ikke nye krav, der indføres med denne API-version.

QA-tjekliste til Shopify Metafields

Brug denne korte tjekliste, før du opgraderer berørte integrationer:

• Find GraphQL Admin API-forespørgsler, der filtrerer på metafields.
• Registrér owner type, namespace, key og type for hvert berørt metafield.
• Bekræft, at hvert filtreret metafield har en definition.
• Bekræft, at definitionen tillader filtrering.
• Bekræft, at metafield-typen understøtter det filter eller den sammenligning, der bruges.
• Ret ugyldige metafield-filtre.
• Test berørte forespørgsler mod API 2026-10.
• Bekræft, at de forventede ressourcer returneres efter filtrering.
• Gennemgå relevante afhængigheder til Customer Account API separat.
• Dokumentér ejerskab af metafields, hvor flere systemer afhænger af det samme felt.
• Gennemgå legacy- eller duplikerede custom fields, før du ændrer schemaet.

Opsummering

Shopify API 2026-10 gør metafield-filtrering mere strikt, så det er nu det rette tidspunkt at gennemgå de brugerdefinerede data, som dine apps og integrationer er afhængige af.

Før du opgraderer, skal du sikre dig, at filtrerede metafields har gyldige definitioner, at de nødvendige filtrerings-capabilities er aktiveret, og at berørte GraphQL-forespørgsler er testet mod den nye API-version. Et kort metafield-audit nu kan hjælpe med at forebygge fejl, der ellers kunne være undgået, når 2026-10 går live den 1. oktober 2026.