Så importerar du produkter till WooCommerce i bulk

Alternativ 1: WooCommerce inbyggda CSV-importör

WooCommerce levereras med en CSV-importör och -exportör för produkter. Gå till Produkter → Alla produkter i WordPress-administrationen och välj Importera. Ladda upp din CSV-fil, koppla dess kolumner till WooCommerce-fält och kör importen. Om du markerar ”Uppdatera befintliga produkter” kan du uppdatera produkter som matchas på ID eller SKU i stället för att skapa dubbletter.

• Exportera först en befintlig produkt och använd filen som mall — den visar exakt vilka kolumnnamn din butik förväntar sig.
• Typiska kolumner är Type, SKU, Name, Published, Short description, Description, Regular price, Categories, Tags, Images och Attribute 1 name / Attribute 1 value(s).
• Bilder importeras från webbadresser, så de måste vara offentligt nåbara när importen körs.
• Variabla produkter kräver en överordnad rad av typen ”variable” och en rad per variation som hänvisar till den överordnade produkten.
• Mycket stora filer kan ge timeout på delat webbhotell — dela upp dem i omgångar om några hundra rader.

Alternativ 2: Importtillägg

Importtillägg från tredje part lägger till funktioner som kärnimportören saknar: schemalagda eller återkommande importer från ett leverantörsflöde, stöd för XML, regler för fälttransformering och bättre hantering av mycket stora filer. De är lämpliga när en leverantör regelbundet skickar uppdaterade pris- och lagerfiler.

Tilläggen förväntar sig fortfarande strukturerad indata. Om din leverantör skickar PDF-filer i stället för ett flöde tar ett tillägg inte bort arbetet med att omvandla dessa PDF-filer till rader.

Alternativ 3: WooCommerce REST API

Utvecklare och integrationsverktyg kan skapa produkter via WooCommerce REST API, inklusive en batch-slutpunkt som skapar eller uppdaterar många produkter i ett enda anrop. Det passar automatiserade flöden och appar som skapar produkter direkt utan något CSV-steg.

Doc2Shelf använder den här vägen: efter granskning skickar det produkter till WooCommerce som enkla utkastprodukter med långa och korta beskrivningar, så att du kan kontrollera dem i WooCommerce innan du gör dem live. Globala filterattribut och variabla produkter konfigureras separat i WooCommerce.

Förbereda produktdata för en massuppladdning

Oavsett importmetod avgör datakvaliteten resultatet. Innan du importerar:

• Ge varje produkt ett unikt SKU — det är så uppdateringar hittar rätt produkt senare.
• Skapa kategorier och globala attribut i WooCommerce först och hänvisa sedan konsekvent till dem.
• Normalisera specifikationer: samma enheter, samma attributnamn, ett värde per cell.
• Skriv riktiga beskrivningar i stället för att klistra in leverantörens text; marknadsplatser och sökmotorer belönar unik text.
• Importera som utkast vid en första körning — ställ in Published på -1 (0 gör produkterna privata) — och granska sedan ett urval innan du publicerar allt.

När din leverantör bara skickar PDF-filer

Många leverantörer tillhandahåller datablad och kataloger som PDF-filer, inte som CSV-flöden. Då är flaskhalsen extraktionen: någon måste läsa varje PDF, fylla i kolumnerna och skriva en beskrivning.

Du kan göra det manuellt, eller extrahera data med ett verktyg och granska dem. Doc2Shelf läser leverantörs-PDF:er, extraherar specifikationerna för granskning, tar fram utkast till långa och korta WooCommerce-beskrivningar och skapar produkterna som utkast via REST API — och ersätter därmed kalkylbladssteget för kataloger som kommer från PDF-filer.

Vanliga importfel i WooCommerce

Om en import misslyckas eller ger oväntade resultat, kontrollera först följande:

• Dubbla eller saknade SKU:er som gör att rader hoppas över eller att produkter dupliceras.
• Fel filkodning — spara CSV-filen som UTF-8 så att tecken med accenter importeras korrekt.
• Bildadresser som omdirigerar, kräver inloggning eller pekar på mycket stora filer.
• Kategorisökvägar som skrivs inkonsekvent (använd ”Förälder > Underkategori” för nästlade kategorier).
• Variationer vars attributvärden inte stämmer med den överordnade produktens attributvärden.

Referens för kolumner i WooCommerce produkt-CSV

Den inbyggda importen läser en fast uppsättning kolumnnamn. Om du exporterar en produkt från din egen butik får du exakt de rubriker som din WooCommerce-version förväntar sig; tabellen nedan förklarar de kolumner som är viktigast för en massuppladdning. Bara Name krävs — alla andra kolumner är valfria, men en katalog som importerats utan Type, SKU, priser och kategorier ger mycket manuellt arbete efteråt.

Kolumner med en enhet i rubriken, till exempel Weight och de tre måtten, visar den enhet som är inställd i butikens inställningar, så kopiera de rubrikerna från en export i stället för att skriva dem för hand. Anpassade data som saknar egen kolumn läggs i en kolumn vars rubrik börjar med meta: följt av fältnyckeln.

Variabla produkter i en CSV: överordnade rader och variantrader

En variabel produkt sprids över flera rader: en överordnad rad som definierar produkten och de attributvärden den erbjuder, och en rad per variant som innehåller pris, SKU och lagersaldo för en enskild kombination. Den överordnade raden har Type ”variable”; varje variantrad har Type ”variation” och pekar tillbaka på den överordnade produkten i kolumnen Parent, med den överordnade produktens SKU eller id: följt av dess ID.

Attributkolumnerna knyter ihop raderna. På den överordnade raden listar Attribute 1 value(s) alla värden som produkten erbjuder, åtskilda med kommatecken. På varje variant står samma Attribute 1 name med exakt ett av dessa värden. Stavning och versaler måste stämma överens: en variant som anger ”red” under en överordnad produkt som erbjuder ”Red” kan sakna ett användbart attributvärde.

Ställ in Attribute 1 global på 1 på den överordnade produkten och dess varianter när du använder ett attribut för hela butiken som skapats under Products → Attributes — det är det som lagerfiltrering och filterwidgetar arbetar med. Sedan WooCommerce 11.1 kan en uppdateringsimport också lägga till nya varianter i en variabel produkt som redan finns, så att du kan utöka ett sortiment utan att bygga om den överordnade produkten.

• Placera varje överordnad rad ovanför sina varianter så att filen är lätt att kontrollera och den överordnade produkten finns när varianterna hänvisar till den.
• Ge varje variant en egen SKU och ett eget pris; en variant utan pris kan inte köpas.
• Använd Attribute 1 default på den överordnade raden för att styra vilket alternativ som är förvalt.

Lägga till produktbilder via CSV-filen

Kolumnen Images tar en eller flera bild-URL:er åtskilda med kommatecken. Den första URL:en blir den utvalda bilden och resten bildar produktgalleriet i den ordning de anges. Under importen laddar WordPress ned varje fil till ditt mediebibliotek, så varje URL måste vara offentligt nåbar vid det tillfället — ingen inloggning, ingen delningslänk som löper ut och ingen omdirigering till en webbsida i stället för filen.

Bilder är oftast den långsammaste delen av en import: några hundra produkter med fem bilder var innebär över tusen nedladdningar. Ändra storlek på bilderna innan du lägger upp dem, använd beskrivande filnamn (kettle-red-front.jpg, inte IMG_0042.jpg) och dela upp stora kataloger i mindre filer.

Den inbyggda importen kan inte ange alternativtext för bilder. Lägg till alternativtexten efteråt i mediebiblioteket, via REST API eller med ett importtillägg som stöder det. En variant kan ha en enda bild, så ge varje variantrad högst en URL.

Skapa produkter i bulk med WooCommerce REST API

REST API är den bättre vägen när importer upprepas, när produktdata redan finns i ett annat system eller när ingen ska behöva hantera en CSV alls. Dess batch-endpoint för produkter (POST /wp-json/wc/v3/products/batch) accepterar skapa-, uppdatera- och radera-åtgärder i en enda förfrågan.

Som standard är en batchförfrågan begränsad till 100 objekt sammanlagt för skapande, uppdateringar och borttagningar. Samma gräns gäller för batch-endpoints för varianter, kategorier, attribut och attributtermer. En katalog med 1000 produkter kräver därför minst tio förfrågningar, och fler när varianter läggs till.

1. Skapa en REST API-nyckel med läs-/skrivbehörighet under WooCommerce → Settings → Advanced → REST API, eller låt en app begära en via WooCommerce auktoriseringsskärm.
2. Skapa först kategorierna, de globala attributen och attributtermerna, och notera deras ID:n.
3. Skicka enkla och överordnade produkter i batchar om upp till 100, med statusen inställd på utkast.
4. Skapa varianterna för varje variabel produkt via den produktens batch-endpoint för varianter.
5. Kontrollera resultatet för varje objekt i svaret och försök igen endast med de objekt som misslyckades.
6. Kontrollera ett urval av utkasten stickprovsvis i administrationen och publicera dem sedan.

Välja tillägg eller väg för massuppladdning av produkter i WooCommerce

Om den inbyggda importen inte räcker bör du bedöma ett importtillägg efter hur det hanterar dina data, inte efter hur lång funktionslistan är, och testa det på en staging-kopia av butiken med en riktig leverantörsfil innan du binder dig. Tabellen jämför de fyra vägarna, följt av frågor som är värda att ställa om vilket tillägg som helst.

• Källformat: endast CSV, eller även XML, kalkylblad och externa flöden som hämtas via URL.
• Schemaläggning: om det kan köra om en import enligt schema för att fånga upp nya priser och lagersaldon.
• Mappning och transformeringar: byta namn på kolumner, dela upp värden, konvertera enheter och tillämpa prisregler under importen.
• Variabla produkter: om det bygger överordnade produkter, varianter och globala attribut på ett tillförlitligt sätt.
• Bilder: hur det laddar ned dem, om det upptäcker dubbletter och om det anger alternativtext.
• Stora filer: bearbetning i bakgrunden eller i delar så att långa importer inte får timeout.
• Uppdateringsregler: vilken nyckel det matchar på (ID, SKU eller GTIN) och vilka fält det får skriva över.

Checklista före import och felåtgärder

De flesta misslyckade importer beror på ett överhoppat förberedelsesteg. Gå igenom checklistan före varje stor import och använd tabellen för att felsöka problem som ändå uppstår.

1. Säkerhetskopiera databasen, eller kör importen på en staging-kopia av butiken.
2. Exportera en befintlig produkt och kopiera dess rubrikrad till din fil.
3. Skapa de kategorier, globala attribut och attributtermer som filen hänvisar till.
4. Kontrollera att varje SKU är unik och att varje variants Parent-värde matchar en befintlig överordnad SKU.
5. Använd vanliga tal i kolumnerna för pris, lagersaldo, vikt och mått.
6. Öppna ett urval av bild-URL:erna i ett privat webbläsarfönster för att bekräfta att de laddas utan inloggning.
7. Ställ in Published på -1 så att produkterna kommer in som utkast.
8. Spara filen som UTF-8 CSV.
9. Importera en testfil med tio rader, granska resultatet och importera sedan resten i batchar.

Testa med dummyprodukter före den riktiga importen

En liten dummyfil fångar upp mappningsfel innan de berör hundratals produkter. Bygg den utifrån din riktiga mall så att rubrikerna är identiska och ge varje testprodukt en tydlig markering — ett SKU-prefix ”TEST-” och en etikett ”test” — så att du kan hitta och radera produkterna efteråt.

Täck in alla fall som din riktiga fil innehåller, inte bara det enkla. Omkring tio rader räcker vanligtvis:

• En enkel produkt där alla kolumner du tänker använda är ifyllda.
• En variabel produkt med två attribut och minst tre varianter.
• En produkt med ett galleri med flera bilder och en utan bilder.
• En produkt i en nästlad kategori som ännu inte finns.
• En produkt med accenttecken, citattecken och ett kommatecken i beskrivningen.
• En rad som uppdaterar en befintlig produkt via SKU.
• Kontrollera resultaten i administrationen och i webbutiken — priser, rullgardinsmenyer för varianter, bildordning och kategorisidor — och radera sedan testprodukterna före den riktiga importen.