Vodnik
Kako izvesti množični uvoz izdelkov v Shopify
Shopify lahko iz datoteke CSV naenkrat ustvari ali posodobi veliko izdelkov. Tukaj je razloženo, kako uvoz deluje, kje se zaplete in kaj storiti, kadar podatki o izdelkih izvirajo iz PDF-jev dobaviteljev.
Uvoz izdelkov CSV v Shopify je standardni način za množično dodajanje kataloga. Pripravite preglednico v obliki Shopify, jo naložite v skrbniškem vmesniku, Shopify pa ustvari izdelke, različice in slike.
Tako kot pri vsakem uvozu je uspeh odvisen od podatkov, ki jih vnesete. Ta vodnik obravnava postopek s CSV, alternative in pripravo, ki vas obvaruje pred popravljanjem stotin izdelkov pozneje.
Možnost 1: uvoz izdelkov CSV v skrbniškem vmesniku Shopify
V skrbniškem vmesniku Shopify odprite „Products“ in izberite „Import“. Naložite CSV v obliki izdelkov Shopify, se odločite, ali naj se izdelki z enakim handle prepišejo, si oglejte predogled in potrdite. Shopify datoteko obdela v ozadju in vas obvesti, ko je končano.
- Začnite z Shopifyjevo vzorčno predlogo CSV za izdelke ali izvozite obstoječi izdelek, da vidite točne stolpce.
- Stolpec URL handle (v starejših predlogah Handle) identificira izdelek; vrstice z istim handle so različice ali dodatne slike istega izdelka.
- Značilni stolpci so Title, Description (Body (HTML)), Vendor, Product category, Type, Tags, Status, Option1 name / Option1 value, SKU (Variant SKU), Price, Barcodes (Variant Barcode) in Product image URL (Image Src).
- Slike se ob uvozu pridobijo z javnih URL-jev.
- Datoteko shranite kot CSV v UTF-8, da posebni znaki ostanejo nedotaknjeni.
Pravilno ravnanje z različicami
Različice največ težav povzročijo pri prvih uvozih. Vsak izdelek ima lahko do tri možnosti (na primer velikost, barva, material). Prva vrstica izdelka vsebuje polja na ravni izdelka in imena možnosti; vsaka naslednja vrstica z istim handle doda eno različico z vrednostmi možnosti, SKU, ceno in zalogo.
Imena možnosti naj bodo v vseh vrsticah enaka, kombinacija vrednosti možnosti vsake različice pa enolična, tako da vsaka vrstica ustreza natanko eni različici. Vrstica, ki ima stolpce različice, nima pa Option1 name in Option1 value, povzroči, da Shopify ustvari privzeto različico in izbriše obstoječe.
Možnost 2: aplikacije za množični uvoz
Aplikacije za uvoz iz Shopify App Store razširijo izvorni CSV: podpora za Excel in Google Preglednice, metapolja, načrtovani uvozi iz virov podatkov dobaviteljev in selitev z drugih platform. Vredno jih je upoštevati, kadar uvažate večkrat ali potrebujete polja, ki jih standardni CSV ne pokriva.
Možnost 3: Shopify Admin API
Aplikacije in integracije po meri lahko izdelke namesto prek datoteke CSV ustvarijo prek Shopify Admin API. S tem se popolnoma izognete krogom prek preglednic, tako pa številna orodja za kataloge in sezname izdelkov ustvarjajo izdelke v Shopify.
Doc2Shelf uporablja to pot: trgovino povežete z OAuth, pregledani seznami izdelkov pa se ustvarijo kot osnutki izdelkov s slikami, cenami in kategorijami.
Priprava podatkov o izdelkih za Shopify
Pred vsakim množičnim uvozom preverite, da:
- ima vsak izdelek enolični handle in vsaka različica enolični SKU;
- naslovi sledijo enemu vzorcu (na primer znamka + izdelek + ključni atribut);
- so opisi vaše lastno besedilo, ne prilepljeno besedilo dobavitelja, in uporabljajo preprost HTML;
- specifikacije uporabljajo dosledne enote in imena, da lahko postanejo možnosti, oznake ali metapolja;
- se izdelki najprej uvozijo neobjavljeni, da lahko pregledate vzorec, preden gredo v živo.
Kadar podatki o izdelkih izvirajo iz PDF-jev dobaviteljev
Uvoz CSV predpostavlja, da že imate čiste, strukturirane podatke. Kadar dobavitelji specifikacije in kataloge pošiljajo kot PDF-je, mora nekdo najprej izvleči naslove, specifikacije in identifikatorje ter napisati opise — to je običajno najpočasnejši del celotnega opravila.
Doc2Shelf ta korak nadomesti: prebere PDF-je dobaviteljev, izvleče podatke o izdelkih z informacijami o zaupanju za pregled, pripravi besedilo seznama izdelkov za Shopify in pregledane izdelke v povezani trgovini ustvari kot osnutke, brez CSV.
Stolpci CSV izdelkov za Shopify: trenutna imena in starejše ustreznice
Shopify je preimenoval več stolpcev CSV izdelkov. Njegova trenutna referenca CSV uporablja oznake, kot so URL handle, Description, SKU in Barcodes, medtem ko številne predloge in vodniki še vedno prikazujejo Handle, Body (HTML), Variant SKU in Image Src. Shopify navaja, da ohranja združljivost s starejšimi imeni stolpcev, zato se starejša datoteka še vedno uvozi — vendar sveži izvoz uporablja trenutne oznake, datoteko, ki meša oba sloga, pa je težko preveriti.
Tabela zajema stolpce, ki jih potrebuje večina množičnih uvozov. Preimenovanje iz Barcode v Barcodes je navedeno v dokumentaciji Shopify; druge starejše oznake so ujete glede na to, kaj polje vsebuje, zato jih potrdite z izvozom iz lastne trgovine. Glave razlikujejo velike in male črke.
| Trenutni stolpec | Kaj vsebuje | Primer | Starejša oznaka ali opombe |
|---|---|---|---|
| Title | Ime izdelka | Kuhalnik iz nerjavnega jekla 1,7 L | Obvezno za ustvarjanje izdelka. |
| URL handle | Enolični identifikator izdelka, ki se uporablja v URL-ju izdelka | steel-kettle | Starejše predloge ga imenujejo Handle. Vrstice z istim handle pripadajo istemu izdelku. |
| Description | Opis izdelka | Brezžični kuhalnik z … | Starejše predloge ga imenujejo Body (HTML). |
| Vendor | Znamka ali proizvajalec | Acme | — |
| Product category | Kategorija iz Standard Product Taxonomy | hg-15-1-2 | Celotna pot kategorije ali ID kategorije, ne obeh. |
| Type | Vaša lastna vrsta izdelka | Električni kuhalnik | Prosta oblika, za razliko od kategorije. |
| Tags | Oznake, ločene z vejicami | brezžični, kuhinja | Do 250 oznak na izdelek. |
| Status | Status izdelka | draft | Uvozite kot osnutek, pregledajte, nato aktivirajte. |
| SKU | SKU različice | KTL-SLV | Starejše predloge ga imenujejo Variant SKU. |
| Barcodes | Črtne kode različice | gtin:4006381333931 | Prej Barcode (še prej Variant Barcode). Več jih ločite s podpičji; predpona tipa ni obvezna. |
| Option1 name / Option1 value | Prva možnost in vrednost te različice | Barva / Srebrna | Option2 in Option3 sledita istemu vzorcu. |
| Option1 LinkedTo | Povezava možnosti z metapoljem kategorije | product.metafields.shopify.[attribute] | Neobvezno; glejte razdelek o taksonomiji spodaj. |
| Price / Compare-at price | Prodajna cena in primerjalna cena | 49.90 / 59.90 | Stolpci Price / [Market] vsebujejo cene za posamezne trge. |
| Inventory quantity | Zaloga na voljo | 25 | Deluje skupaj s stolpcem Inventory tracker. |
| Weight value (grams) | Teža različice v gramih | 1200 | Starejše predloge ga imenujejo Variant Grams. Weight unit for display določa enoto, ki jo vidijo kupci. |
| Product image URL | Javni URL slike izdelka | https://cdn.example.com/kettle.jpg | Starejše predloge ga imenujejo Image Src. |
| Image position / Image alt text | Vrstni red galerije in nadomestno besedilo | 1 / Jekleni kuhalnik, pogled od spredaj | Nadomestno besedilo do 512 znakov. |
| Variant image URL | Slika, prikazana ob izbiri te različice | https://cdn.example.com/kettle-black.jpg | — |
| SEO title / SEO description | Naslov in meta opis za rezultate iskanja | — | Do 70 oziroma 320 znakov. |
| Stolpci metapolj | Vrednosti metapolj izdelka | Material (product.metafields.custom.material) | Oblika glave: Name (product.metafields.namespace.key). |
Različice in možnosti: omejitve in pasti
Izdelek v Shopify ima lahko do tri možnosti — na primer velikost, barvo in material — in do 2.048 različic. Omejitev različic je bila 100, dokler je Shopify oktobra 2025 ni povečal, zato starejše predloge in vodniki še vedno navajajo staro številko. Nekatere teme, aplikacije in prodajni kanali so bili zasnovani glede na staro omejitev, zato to preverite, preden uvozite izdelek s stotinami različic.
Prva vrstica izdelka vsebuje polja na ravni izdelka in imena možnosti. Vsaka naslednja vrstica z istim URL handle doda eno različico z vrednostjo možnosti, SKU, ceno, težo in zalogo, polja na ravni izdelka pa pusti prazna.
Dve vedenji presenetita pri posodobitvenih uvozih. Če vrstica vsebuje stolpce različice, kot sta SKU ali teža, izpusti pa Option1 name in Option1 value, Shopify ustvari privzeto različico in izbriše obstoječe različice. Sprememba vrednosti možnosti — na primer preimenovanje „Grey“ v „Gray“ — izbriše ID-je različic in ustvari nove, kar lahko pokvari aplikacije in vire, ki se sklicujejo na te ID-je.
| Vrstica | URL handle | Title | Option1 name | Option1 value | SKU |
|---|---|---|---|---|---|
| Prva vrstica | steel-kettle | Jekleni kuhalnik | Barva | Srebrna | KTL-SLV |
| Naslednja vrstica | steel-kettle | (prazno) | (prazno) | Črna | KTL-BLK |
Slike izdelkov v CSV za Shopify
Shopify med uvozom prenese slike iz stolpca Product image URL, zato mora biti vsak URL javno dostopen in kazati neposredno na datoteko slike. Povezave, ki zahtevajo prijavo, odprejo stran s predogledom ali potečejo pred uvozom, so običajni razlogi za manjkajoče slike.
Izdelek lahko vsebuje do 250 slik ali drugih medijev. Prvo sliko navedite v prvi vrstici izdelka; vsako naslednjo sliko dodajte v lastni vrstici z istim URL handle, URL-jem slike, položajem slike (Image position) in nadomestnim besedilom slike (Image alt text). Če želite ob izbiri različice prikazati določeno sliko, njen URL navedite v stolpcu Variant image URL v vrstici te različice.
Nadomestno besedilo je lahko dolgo do 512 znakov, Shopify pa priporoča 125 ali manj. Opišite, kaj slika prikazuje — „Kuhalnik iz nerjavnega jekla, pogled od spredaj z merilnikom vode“ — in ne ponavljajte naslova izdelka.
Kategorija izdelka, metapolja in Standard Product Taxonomy
Stolpec Product category dodeli kategorijo iz Shopify Standard Product Taxonomy, izbrano glede na glavno funkcijo izdelka. Vnesite celotno pot kategorije, na primer Home & Garden > Linens & Bedding > Bedding > Bed Sheets, ali ID kategorije, na primer hg-15-1-2 — ne obeh. Izdelek brez kategorije se obravnava kot nekategoriziran.
Nastavitev kategorije odklene njena metapolja kategorije, ki jih taksonomija imenuje atributi izdelka. Kategorija Shirts ima na primer devet, med njimi velikost, izrez, tkanino in barvo, vrednosti barve pa se lahko prikažejo kot vzorčki. Stolpec Option1 LinkedTo poveže možnost različice z enim od teh metapolj kategorije.
Kategorija je pomembna tudi onkraj navigacije: Shopify Tax jo uporablja za določanje davčnih stopenj. Type pa je prosta oznaka, ki jo določite sami, uporabna za lastne filtre in poročila.
Metapolja izdelka po meri se uvozijo prek stolpcev z glavo Name (product.metafields.namespace.key), na primer Material izdelka (product.metafields.custom.material). Metapolja različic v CSV izdelkov niso podprta, zato jih nastavite v skrbniškem vmesniku, z aplikacijo ali prek API-ja.
Omejitve CSV za Shopify in dolžine polj SEO
To so omejitve, ki jih Shopify dokumentira za uvoze CSV izdelkov in zapise izdelkov. Številke v starejših vodnikih — zlasti omejitev 100 različic — so zastarele.
Stolpca SEO title in SEO description izpolnita naslov in meta opis, uporabljena v rezultatih iskanja. Napišite ju za vsak izdelek posebej in ne kopirajte enega vzorca čez ves katalog: na začetek postavite ime izdelka in atribut, ki ga kupci iščejo, na primer velikost, material ali številko modela.
| Postavka | Omejitev | Kaj storiti |
|---|---|---|
| Velikost datoteke CSV | 15 MB | Velike kataloge razdelite; vse vrstice izdelka naj bodo v isti datoteki. |
| Možnosti na izdelek | 3 | Nadaljnje razlike modelirajte kot ločene izdelke ali metapolja. |
| Različice na izdelek | 2.048 | Preverite, ali vaša tema in aplikacije obvladajo veliko število različic. |
| Slike in mediji na izdelek | 250 | V galeriji naj bodo samo slike, ki kupcem pomagajo pri odločitvi. |
| Oznake na izdelek | 250 | Oznake uporabljajte za filtriranje in avtomatizacijo. |
| Črtne kode na izdelek ali različico | 20 | Dodajte predpono tipa, kot je gtin:, kadar tip poznate. |
| SEO naslov | 70 znakov | Na začetek postavite ime izdelka in ključni atribut. |
| SEO opis | 320 znakov | Povzemite izdelek, ključne podrobnosti najprej. |
| Nadomestno besedilo slike | 512 znakov (priporočeno 125 ali manj) | Opišite, kaj slika prikazuje. |
Prepis ali ustvarjanje: kako se obnašajo posodobitve
Za ustvarjanje izdelka CSV potrebuje samo Title; za dodajanje različic je potreben tudi URL handle. Za posodobitev obstoječega izdelka Shopify potrebuje URL handle in Title, ob zagonu uvoza pa izberete prepis izdelkov z ujemajočimi se handle.
Prepis obravnavajte kot merodajen za vsak stolpec, ki ga vključite. Najvarnejši vzorec je izvoz, urejanje, ponovni uvoz: izvozite izdelke, ki jih želite spremeniti, uredite samo celice, ki jih je treba spremeniti, stolpce možnosti pustite na mestu in urejeno datoteko uvozite z vklopljenim prepisom. Redka datoteka, zgrajena iz nič, zlahka sproži zgoraj opisano brisanje različic.
Pred potrditvijo preberite predogled uvoza, večjo posodobitev pa najprej zaženite na peščici izdelkov. Izvoz, ki ste ga naredili pred urejanjem, je vaša pot nazaj, če gre kaj narobe.
Kontrolni seznam pred uvozom in odpravljanje težav
Pred velikim uvozom opravite ta opravila; tabela za njimi zajema najpogostejše težave.
- Iz svoje trgovine izvozite en izdelek in ponovno uporabite njegovo vrstico glave, da se imena stolpcev natančno ujemajo.
- Vsakemu izdelku dodelite enolični URL handle, vsaki različici pa enolični SKU.
- Preverite dosledno črkovanje imen in vrednosti možnosti ter potrdite, da ima vsaka vrstica različice svojo vrednost možnosti.
- Polje Product category izpolnite s potjo kategorije ali ID-jem, prekopiranim iz taksonomije.
- Vzorec URL-jev slik odprite v zasebnem oknu brskalnika in potrdite, da se naložijo brez prijave.
- Pri prvem zagonu nastavite Status na draft.
- Shranite kot CSV v UTF-8 in potrdite, da je datoteka manjša od 15 MB.
- Uvozite pet do deset izdelkov, jih pregledajte v skrbniškem vmesniku in na spletni trgovini, nato uvozite preostale.
| Težava | Verjeten vzrok | Rešitev |
|---|---|---|
| Datoteka zavrnjena | Večja od 15 MB ali ni shranjena kot CSV v UTF-8 | Datoteko razdelite po izdelkih in ponovno shranite kot CSV v UTF-8 |
| Stolpec prezrt | Glava z napako v črkovanju ali drugačno rabo velikih in malih črk | Glave prekopirajte iz svežega izvoza |
| Različice izginejo po posodobitvi | Stolpci različice poslani brez Option1 name in value | Ponovno uvozite z vključenimi stolpci možnosti |
| Aplikacije so izgubile sled različicam | Vrednost možnosti je bila preimenovana, kar je ustvarilo nove ID-je različic | Vrednosti možnosti preimenujte premišljeno in znova povežite prizadete aplikacije |
| Izdelki napačno razdeljeni ali združeni | URL handle se razlikuje med vrsticami istega izdelka | Uporabite en enak handle na izdelek |
| Manjkajoče slike | URL ni javen, ni neposredna povezava do datoteke ali je potekel | Slike gostite na stabilnih javnih URL-jih |
| Kategorija ni nastavljena | Napačno vtipkana pot ali navedena tako pot kot ID | Uporabite natanko enega, prekopiranega iz taksonomije |
| Črtna koda ni sprejeta | Dolžina ne ustreza navedenemu tipu | GTIN: 8, 12, 13 ali 14 števk; UPC: 8 ali 12; EAN: 8 ali 13 |
| Manjkajoče vrednosti metapolj | Napačna oblika glave ali metapolje različice | Uporabite Name (product.metafields.namespace.key); metapolja različic nastavite drugje |
Pogosta vprašanja
- Kako brezplačno množično uvozim izdelke v Shopify?
- Uporabite vgrajeni uvoz CSV pod „Products → Import“. Vključen je v vsak paket Shopify in obdela izdelke, različice in slike iz datoteke CSV v obliki Shopify.
- Ali lahko izdelke v Shopify naložim iz Excela?
- Izvorni uvoznik potrebuje CSV, zato preglednico Excel shranite kot CSV v UTF-8 z imeni stolpcev Shopify. Nekatere aplikacije za uvoz lahko datoteke Excel preberejo neposredno.
- Ali uvoz CSV prepiše moje obstoječe izdelke?
- Obstoječi izdelki se posodobijo samo, če izberete možnost prepisa izdelkov z enakim handle. Pred potrditvijo preglejte predogled uvoza in najprej preizkusite z majhno datoteko.
- Zakaj se moje slike ne uvozijo?
- URL-ji slik morajo biti javno dostopne neposredne povezave do slikovnih datotek. Povezave, ki zahtevajo prijavo, preusmerjajo na spletno stran ali prihajajo iz začasne skupne rabe datotek, običajno ne delujejo.
- Kateri stolpci so obvezni v CSV izdelkov za Shopify?
- Za ustvarjanje izdelka je obvezen samo Title, pri dodajanju različic pa še URL handle. Za posodobitev obstoječih izdelkov vključite URL handle in Title. Vse drugo je neobvezno, čeprav uporaben seznam izdelka običajno potrebuje ceno, SKU, kategorijo, opis in slike.
- Koliko različic ima lahko izdelek v Shopifyju?
- Do 2.048 različic z največ tremi možnostmi. Shopify je omejitev oktobra 2025 povečal s 100, zato so starejše predloge in vodniki, ki navajajo 100, zastareli.
- Ali lahko s Shopify CSV uvozim metapolja?
- Metapolja izdelka da: dodajte stolpec z naslovom Name (product.metafields.namespace.key). Metapolja različic v CSV za izdelke niso podprta in jih je treba nastaviti v skrbniškem vmesniku, z aplikacijo ali prek API-ja.
- Kolikšna je največja velikost Shopify CSV za izdelke?
- CSV za izdelke ne sme presegati 15 MB. Večje kataloge razdelite na več datotek in vse vrstice istega izdelka obdržite v isti datoteki.