QA-checklista för Shopify-metafält inför API 2026-10

Shopify-metafält gör det möjligt för handlare och appar att lagra anpassad data på Shopify-resurser som produkter, kunder och ordrar. De kan användas för produktinformation, leveransanteckningar, relationer mellan relaterade produkter, automatiseringar i Shopify Flow och backend-processer.

När metafält blir en del av allt mer butikslogik och fler integrationer blir deras konfiguration viktigare, särskilt när appar använder dem i API-frågor.

En viktig förändring kommer med Shopifys Admin GraphQL API version 2026-10, som är planerad till den 1 oktober 2026. Från och med denna version returnerar en fråga som filtrerar på ett metafält som inte är korrekt konfigurerat för filtrering ett fel. Tidigare kunde Shopify tyst ignorera det ogiltiga villkoret och returnera missvisande resultat. Shopify meddelade ändringen i sin developer changelog den 24 juli 2026. 

För utvecklare som underhåller Shopify-appar eller anpassade integrationer är detta en tydlig anledning att se över metafältsdefinitioner och filtrerade GraphQL-frågor innan uppgradering till 2026-10.

Vad som ändras i Shopify API version 2026-10

Från API-version 2026-10 validerar GraphQL Admin API metafältsfilter innan en fråga körs. Enligt Shopify misslyckas ett metafältsfilter ofta när:

• metafältet saknar en definition;
• metafältsdefinitionen inte är konfigurerad för att tillåta filtrering;
• metafältstypen inte stöder filtret eller jämförelsen som används.

Tidigare kunde ett ogiltigt metafältsvillkor ignoreras. Det innebar att en fråga kunde se ut att fungera samtidigt som den returnerade resultat som inte motsvarade det avsedda filtret. Med 2026-10 returnerar Shopify i stället ett fel som förklarar filtreringsproblemet. Ändringen påverkar appar och integrationer som filtrerar resurser efter metafält via GraphQL Admin API i 2026-10 eller senare. Frågor som använder 2026-07 och tidigare behåller det tidigare beteendet tills de uppgraderas.

Frågor som använder metafält som är korrekt konfigurerade för filtrering, tillsammans med jämförelser som stöds, bör fortsätta att fungera som tidigare.

Varför metafältsdefinitioner är viktiga

En metafältsdefinition fastställer struktur och regler för metafält som delar ett visst namespace och en viss nyckel. Definitioner kan ange egenskaper som:

• datatyp
• valideringsregler
• åtkomstinställningar
• stödda funktioner

Shopify har särskild dokumentation för hur dessa definitioner hanteras.

För filtrering är en funktion särskilt viktig: adminFilterable. När den är aktiverad för en definition som stöds kan metafältsvärden användas vid filtrering av resurstyper som stöds i Shopify Admin och GraphQL Admin API.

Shopify anger för närvarande stöd för:

• Produkter
• Företag
• Företagsplatser
• Metaobjekt
• Ordrar

Det finns ytterligare begränsningar beroende på resurs och metafältstyp. Shopify anger till exempel att Admin Filterable inte är tillgängligt för JSON-metafält eller rich text-metafält. Det betyder att bara förekomsten av ett metafält inte garanterar att det kan användas i ett GraphQL-filter. En giltig filtreringskonfiguration beror på definitionen, dess funktioner, metafältstypen och jämförelsen som används i frågan.

Andra nyliga Shopify-ändringar bygger också på metafältsdefinitioner

Filtreringsuppdateringen i 2026-10 är inte den enda nyliga Shopify-ändringen som gör metafältsdefinitioner relevanta.

Åtkomst via Customer Account API

Den 16 juni 2026 ändrade Shopify hur vissa metafält kan nås via Customer Account API. Metafält som lagras på app resource måste nu ha en metafältsdefinition och rätt behörigheter för kundkonto för att vara åtkomliga via API:et.

Shopify rekommenderar utvecklare vars appar är beroende av dessa fält i customer account UI extensions, Hydrogen eller headless-butiker att säkerställa att metafälten har definitioner och lämpliga åtkomstinställningar.

Viktigt är att Shopify anger att metafält som ägs av Customer- eller Order-resurser inte påverkas av just denna ändring.

Metafältsändringar kan användas i Shopify Events

Shopify utökade också sin utvecklarförhandsvisning för Events i juli 2026. Appar kan prenumerera på riktade metafältsändringar på resurser som inkluderar:

• Produkt
• Order
• Kund
• Kollektion
• Plats

Detta kan göra det möjligt för en app att reagera på en specifik ändring i anpassad data i stället för att prenumerera på varje allmän resursuppdatering och jämföra de resulterande payloads. Denna funktionalitet bör dock ännu inte betraktas som en stabil API-funktion för produktion. Shopifys nuvarande exempel konfigurerar Events med: api_version = "unstable"
Events-funktionen som refereras här är därför fortfarande knuten till Shopifys developer preview-/unstable-API-miljö.

Tillsammans visar dessa ändringar varför utvecklare bör ha koll på vilka metafält deras applikationer är beroende av, hur de är definierade och var de används.

QA-checklista för Shopify-metafält inför 2026-10

Innan du uppgraderar berörda integrationer till API 2026-10 bör du gå igenom de metafält som används i GraphQL-filtrering och bekräfta att de är korrekt konfigurerade.

1. Hitta GraphQL-frågor som filtrerar på metafält
   Identifiera frågor i dina appar och integrationer som använder metafält som filter i GraphQL Admin API.
2. Bekräfta metafältsdefinitioner
   Kontrollera att varje metafält som används för filtrering har en lämplig definition med rätt owner type, namespace, key och datatyp.
3. Kontrollera filtreringsfunktioner och fälttyper
   Verifiera att adminFilterable är aktiverat där det krävs och att metafältstypen stöder filtret eller jämförelsen som används i frågan.
4. Testa frågor mot API 2026-10
   Kör berörda frågor med API-version 2026-10 och bekräfta att de returnerar förväntade resultat utan fel kopplade till metafältsfiltrering. Shopify rekommenderar uttryckligen att frågor som filtrerar på metafält testas före uppgradering.
5. Granska relaterade API-beroenden
   Om din implementation använder metafält på app resource via Customer Account API, bekräfta att nödvändiga definitioner och åtkomstinställningar finns på plats. Om du använder Shopify Events bör du också se över arbetsflöden som reagerar på metafältsändringar. Observera att denna Events-funktion för närvarande använder Shopifys API-version unstable.
6. Dokumentera ägarskap och äldre fält
   Dokumentera vilken app, integration eller vilket team som ansvarar för viktiga metafält. Identifiera också duplicerade eller äldre fält innan du gör schemaändringar. Detta är inget nytt krav i API 2026-10, men det kan göra metafältsberoenden enklare att underhålla och granska.

Vänta inte till API-uppgraderingen med att hitta ogiltiga filter

Från och med Admin GraphQL API version 2026-10 returnerar ogiltiga metafältsfilter fel i stället för att ignoreras tyst. Innan du uppgraderar bör du gå igenom de metafält som dina integrationer använder för filtrering, bekräfta att deras definitioner och filtreringsfunktioner är korrekt konfigurerade och testa berörda frågor mot 2026-10.

Ytterligare kontroller, som att dokumentera ägarskap eller gå igenom äldre fält, är användbara best practices men är inte nya krav som införs med denna API-version.

QA-checklista för Shopify-metafält

Använd denna korta checklista innan du uppgraderar berörda integrationer:

• Hitta GraphQL Admin API-frågor som filtrerar på metafält.
• Dokumentera owner type, namespace, key och typ för varje berört metafält.
• Bekräfta att varje filtrerat metafält har en definition.
• Verifiera att definitionen tillåter filtrering.
• Bekräfta att metafältstypen stöder filtret eller jämförelsen som används.
• Rätta ogiltiga metafältsfilter.
• Testa berörda frågor mot API 2026-10.
• Bekräfta att förväntade resurser returneras efter filtrering.
• Granska relevanta beroenden till Customer Account API separat.
• Dokumentera ägarskap för metafält där flera system är beroende av samma fält.
• Gå igenom äldre eller duplicerade anpassade fält innan du gör schemaändringar.

Sammanfattning

Shopify API 2026-10 skärper filtreringen av metafält, så nu är rätt tid att se över den anpassade data som dina appar och integrationer är beroende av.

Innan du uppgraderar bör du säkerställa att filtrerade metafält har giltiga definitioner, att nödvändiga filtreringsfunktioner är aktiverade och att berörda GraphQL-frågor har testats mot den nya API-versionen. En kort genomgång av metafält nu kan hjälpa dig att undvika onödiga fel när 2026-10 lanseras den 1 oktober 2026.