Návod
Jak hromadně nahrát produkty do Shopify
Shopify umí z jednoho souboru CSV vytvořit nebo aktualizovat mnoho produktů najednou. Zde je popsáno, jak import funguje, kde se komplikuje a co dělat, když produktová data vznikají v PDF od dodavatelů.
Import produktů z CSV v Shopify je standardní způsob, jak hromadně přidat katalog. Připravíte tabulku ve formátu Shopify, nahrajete ji v administraci a Shopify vytvoří produkty, varianty a obrázky.
Jako u každého importu závisí úspěch na datech, která do něj vložíte. Tento návod popisuje proces s CSV, alternativy a přípravu, která vás ušetří úklidu stovek produktů po importu.
Možnost 1: Import produktů z CSV v administraci Shopify
V administraci Shopify přejděte do „Products“ a zvolte „Import“. Nahrajte CSV v produktovém formátu Shopify, rozhodněte, zda se mají produkty se shodným handle přepsat, zobrazte náhled a potvrďte. Shopify soubor zpracuje na pozadí a po dokončení vás upozorní.
- Vyjděte ze vzorové šablony produktového CSV od Shopify, nebo exportujte existující produkt, abyste viděli přesné sloupce.
- Sloupec URL handle (ve starších šablonách Handle) identifikuje produkt; řádky se stejným handle jsou varianty nebo další obrázky téhož produktu.
- Běžné sloupce zahrnují Title, Description (Body (HTML)), Vendor, Product category, Type, Tags, Status, Option1 name / Option1 value, SKU (Variant SKU), Price, Barcodes (Variant Barcode) a Product image URL (Image Src).
- Obrázky se v době importu stahují z veřejných adres URL.
- Soubor uložte jako CSV v kódování UTF-8, aby zůstaly zachovány speciální znaky.
Správná práce s variantami
Varianty zaskočí většinu prvních importů. Každý produkt může mít až tři volby (například Size, Colour, Material). První řádek produktu nese pole na úrovni produktu a názvy voleb; každý další řádek se stejným handle přidá jednu variantu s hodnotami voleb, SKU, cenou a skladem.
Názvy možností ponechte na všech řádcích totožné a kombinaci hodnot možností každé varianty jedinečnou, aby každý řádek odpovídal právě jedné variantě. Řádek, který má sloupce variant, ale nemá Option1 name a Option1 value, způsobí, že Shopify vytvoří výchozí variantu a stávající varianty odstraní.
Možnost 2: Aplikace pro hromadný import
Importní aplikace z Shopify App Store rozšiřují nativní CSV: podpora Excelu a Google Sheets, metafields, plánované importy z feedů dodavatelů a migrace z jiných platforem. Stojí za zvážení, když importujete opakovaně nebo potřebujete pole, která standardní CSV nepokrývá.
Možnost 3: Shopify Admin API
Aplikace a vlastní integrace mohou vytvářet produkty přes Admin API Shopify místo souboru CSV. Tím se zcela vyhnete pendlování tabulek a tímto způsobem vytváří produkty v Shopify mnoho katalogových a nabídkových nástrojů.
Doc2Shelf používá tuto cestu: obchod propojíte přes OAuth a zkontrolované nabídky se vytvoří jako produkty ve stavu návrhu s obrázky, cenami a kategoriemi.
Příprava produktových dat pro Shopify
Před jakýmkoli hromadným nahráním ověřte, že:
- Každý produkt má jedinečný handle a každá varianta jedinečné SKU.
- Názvy sledují jednotný vzorec (například značka + produkt + klíčový atribut).
- Popisy jsou váš vlastní text, nikoli vložený text dodavatele, a používají jednoduché HTML.
- Specifikace používají jednotné jednotky a názvy, aby se z nich mohly stát volby, štítky nebo metafields.
- Produkty se nejprve importují jako nezveřejněné, abyste mohli před spuštěním zkontrolovat vzorek.
Když produktová data pocházejí z PDF dodavatelů
Import CSV předpokládá, že už máte čistá strukturovaná data. Když dodavatelé posílají technické listy a katalogy jako PDF, musí někdo nejprve extrahovat názvy, specifikace a identifikátory a napsat popisy — obvykle nejpomalejší část celé práce.
Doc2Shelf tento krok nahrazuje: čte PDF od dodavatelů, extrahuje produktová data s informací o spolehlivosti ke kontrole, navrhne text nabídky pro Shopify a vytvoří zkontrolované produkty ve vašem propojeném obchodě jako návrhy, bez CSV.
Sloupce produktového CSV Shopify: současné názvy a starší ekvivalenty
Shopify přejmenoval několik sloupců produktového CSV. Jeho aktuální reference CSV používá názvy jako URL handle, Description, SKU a Barcodes, zatímco mnoho šablon a návodů stále uvádí Handle, Body (HTML), Variant SKU a Image Src. Shopify uvádí, že zachovává zpětnou kompatibilitu se staršími názvy sloupců, takže starší soubor se stále naimportuje — ale nový export používá aktuální názvy a soubor, který míchá oba styly, se špatně kontroluje.
Tabulka pokrývá sloupce, které většina hromadných nahrání potřebuje. Přejmenování z Barcode na Barcodes uvádí dokumentace Shopify; ostatní starší názvy jsou přiřazeny podle toho, co pole obsahuje, proto je ověřte podle exportu z vlastního obchodu. U záhlaví se rozlišují velká a malá písmena.
| Aktuální sloupec | Co obsahuje | Příklad | Starší název nebo poznámky |
|---|---|---|---|
| Title | Název produktu | Nerezová konvice 1,7 l | Vyžaduje se k vytvoření produktu. |
| URL handle | Jedinečný identifikátor produktu použitý v adrese URL produktu | steel-kettle | Starší šablony jej označují Handle. Řádky se stejným handle patří k jednomu produktu. |
| Description | Popis produktu | Bezdrátová konvice s… | Starší šablony jej označují Body (HTML). |
| Vendor | Značka nebo výrobce | Acme | — |
| Product category | Kategorie ze Standard Product Taxonomy | hg-15-1-2 | Úplná cesta kategorie nebo ID kategorie, ne obojí. |
| Type | Váš vlastní typ produktu | Elektrická konvice | Volný text, na rozdíl od kategorie. |
| Tags | Štítky oddělené čárkami | bezdrátová, kuchyně | Až 250 štítků na produkt. |
| Status | Stav produktu | draft | Importujte jako návrh, zkontrolujte a poté aktivujte. |
| SKU | SKU varianty | KTL-SLV | Starší šablony jej označují Variant SKU. |
| Barcodes | Čárové kódy varianty | gtin:4006381333931 | Dříve Barcode (a ještě dříve Variant Barcode). Několik hodnot oddělte středníky; předpona typu je volitelná. |
| Option1 name / Option1 value | První možnost a hodnota této varianty | Barva / Stříbrná | Option2 a Option3 se řídí stejným vzorem. |
| Option1 LinkedTo | Propojení možnosti s metafield kategorie | product.metafields.shopify.[attribute] | Volitelné; viz část o taxonomii níže. |
| Price / Compare-at price | Prodejní cena a srovnávací cena | 49.90 / 59.90 | Sloupce Price / [Market] obsahují ceny pro konkrétní trhy. |
| Inventory quantity | Množství na skladě | 25 | Funguje se sloupcem Inventory tracker. |
| Weight value (grams) | Hmotnost varianty v gramech | 1200 | Starší šablony jej označují Variant Grams. Weight unit for display určuje jednotku, kterou vidí nakupující. |
| Product image URL | Veřejná adresa URL obrázku produktu | https://cdn.example.com/kettle.jpg | Starší šablony jej označují Image Src. |
| Image position / Image alt text | Pořadí v galerii a alternativní text | 1 / Ocelová konvice, pohled zepředu | Alternativní text do 512 znaků. |
| Variant image URL | Obrázek zobrazený po výběru této varianty | https://cdn.example.com/kettle-black.jpg | — |
| SEO title / SEO description | Titulek a meta popis pro výsledky vyhledávání | — | Do 70 a 320 znaků. |
| Metafield columns | Hodnoty metafields produktu | Material (product.metafields.custom.material) | Formát záhlaví: Název (product.metafields.namespace.key). |
Varianty a možnosti: limity a úskalí
Produkt na Shopify může mít až tři možnosti — například Velikost, Barva a Materiál — a až 2 048 variant. Limit variant byl 100, dokud jej Shopify v říjnu 2025 nezvýšil, takže dříve napsané šablony a návody stále uvádějí staré číslo. Některé šablony vzhledu, aplikace a prodejní kanály byly vytvořeny kolem starého limitu, proto si ten svůj ověřte, než naimportujete produkt s stovkami variant.
První řádek produktu nese pole na úrovni produktu a názvy možností. Každý další řádek se stejným URL handle přidá jednu variantu s hodnotou možnosti, SKU, cenou, hmotností a zásobami a pole na úrovni produktu nechá prázdná.
Dvě chování zaskočí při aktualizačních importech. Pokud řádek obsahuje sloupce variant, jako je SKU nebo hmotnost, ale vynechává Option1 name a Option1 value, Shopify vytvoří výchozí variantu a stávající varianty odstraní. A změna hodnoty možnosti — například přejmenování „Šedá“ na „Šedivá“ — odstraní ID variant a vytvoří nová, což může narušit aplikace a feedy, které se na tato ID odkazují.
| Řádek | URL handle | Title | Option1 name | Option1 value | SKU |
|---|---|---|---|---|---|
| První řádek | steel-kettle | Ocelová konvice | Barva | Stříbrná | KTL-SLV |
| Další řádek | steel-kettle | (prázdné) | (prázdné) | Černá | KTL-BLK |
Produktové obrázky v CSV pro Shopify
Shopify stahuje obrázky ze sloupce Product image URL během importu, proto musí být každá adresa URL veřejně přístupná a vést přímo na soubor obrázku. Odkazy, které vyžadují přihlášení, otevírají stránku s náhledem nebo vyprší dřív, než import proběhne, jsou obvyklým důvodem, proč obrázky chybí.
Produkt může obsahovat až 250 obrázků nebo jiných médií. První obrázek uveďte na prvním řádku produktu; každý další obrázek přidejte na samostatný řádek se stejným URL handle, adresou obrázku, jeho Image position a Image alt text. Aby se při výběru varianty zobrazil konkrétní obrázek, uveďte jeho adresu URL ve sloupci Variant image URL na řádku dané varianty.
Alternativní text může mít až 512 znaků a Shopify doporučuje 125 nebo méně. Popište, co obrázek ukazuje — „Nerezová konvice, pohled zepředu s ukazatelem hladiny“ — místo opakování názvu produktu.
Kategorie produktu, metafields a Standard Product Taxonomy
Sloupec Product category přiřazuje kategorii ze Standard Product Taxonomy Shopify, zvolenou podle hlavní funkce produktu. Zadejte buď úplnou cestu, například Home & Garden > Linens & Bedding > Bedding > Bed Sheets, nebo ID kategorie, například hg-15-1-2 — ne obojí. Produkt bez kategorie se považuje za nezařazený.
Nastavení kategorie odemkne její metafields, které taxonomie nazývá produktovými atributy. Kategorie Shirts na Shopify jich má například devět, včetně velikosti, výstřihu, látky a barvy, a hodnoty barev se mohou zobrazovat jako vzorníky. Sloupec Option1 LinkedTo propojuje možnost varianty s jedním z těchto metafields kategorie.
Kategorie má význam nejen pro navigaci: Shopify Tax ji používá ke stanovení daňových sazeb. Type je naproti tomu volný štítek, který si definujete sami, užitečný pro vlastní filtry a sestavy.
Vlastní metafields produktu se importují přes sloupce se záhlavím Název (product.metafields.namespace.key), například Material (product.metafields.custom.material). Metafields variant produktové CSV nepodporuje, proto je nastavte v administraci, pomocí aplikace nebo přes API.
Limity CSV pro Shopify a délky polí SEO
Toto jsou limity, které Shopify dokumentuje pro importy produktového CSV a záznamy produktů. Čísla ve starších návodech — zejména limit 100 variant — jsou zastaralá.
Sloupce SEO title a SEO description vyplňují titulek a meta popis používané ve výsledcích vyhledávání. Pište je pro každý produkt zvlášť, místo abyste jeden vzor kopírovali přes celý katalog: začněte názvem produktu a atributem, který nakupující vyhledávají, například velikostí, materiálem nebo číslem modelu.
| Položka | Limit | Co dělat |
|---|---|---|
| Velikost souboru CSV | 15 MB | Velké katalogy rozdělte; všechny řádky produktu ponechte v jednom souboru. |
| Možnosti na produkt | 3 | Další rozdíly modelujte jako samostatné produkty nebo metafields. |
| Varianty na produkt | 2 048 | Ověřte, že váš motiv a aplikace zvládají velké počty variant. |
| Obrázky a média na produkt | 250 | V galerii ponechte jen obrázky, které nakupujícím pomáhají s rozhodnutím. |
| Štítky na produkt | 250 | Štítky používejte pro filtrování a automatizaci. |
| Čárové kódy na produkt nebo variantu | 20 | Přidejte předponu typu, například gtin:, pokud typ znáte. |
| SEO title | 70 znaků | Začněte názvem produktu a klíčovým atributem. |
| SEO description | 320 znaků | Shrňte produkt, klíčové údaje uveďte na začátku. |
| Alternativní text obrázku | 512 znaků (doporučeno 125 nebo méně) | Popište, co obrázek ukazuje. |
Přepsat, nebo vytvořit: jak se chovají aktualizace
K vytvoření produktu stačí v CSV Title; přidání variant vyžaduje také URL handle. K aktualizaci existujícího produktu Shopify potřebuje URL handle a Title a při zahájení importu zvolíte přepsání produktů se shodným handle.
Přepsání považujte za závazné pro každý sloupec, který zahrnete. Nejbezpečnější postup je export, úprava, opětovný import: exportujte produkty, které chcete změnit, upravte jen buňky, které je třeba změnit, ponechte sloupce možností na místě a upravený soubor naimportujte se zapnutým přepisem. Řídký soubor vytvořený od nuly snadno spustí výše popsané chování, při němž se mažou varianty.
Před potvrzením si přečtěte náhled importu a velkou aktualizaci nejprve vyzkoušejte na hrstce produktů. Export, který jste pořídili před úpravami, je vaší cestou zpět, pokud se něco pokazí.
Kontrolní seznam před importem a řešení potíží
Před velkým importem projděte tyto kroky; tabulka za nimi pokrývá nejčastější problémy.
- Exportujte ze svého obchodu jeden produkt a použijte jeho řádek záhlaví, aby se názvy sloupců přesně shodovaly.
- Dejte každému produktu jedinečný URL handle a každé variantě jedinečné SKU.
- Zkontrolujte jednotný pravopis názvů a hodnot možností a ověřte, že každý řádek varianty má svou hodnotu možnosti.
- Product category vyplňte cestou kategorie nebo ID zkopírovaným z taxonomie.
- Otevřete vzorek adres URL obrázků v anonymním okně prohlížeče a ověřte, že se načtou bez přihlášení.
- Při prvním spuštění nastavte Status na draft.
- Uložte jako CSV v kódování UTF-8 a ověřte, že soubor má méně než 15 MB.
- Naimportujte pět až deset produktů, zkontrolujte je v administraci i v obchodě a poté importujte zbytek.
| Problém | Pravděpodobná příčina | Řešení |
|---|---|---|
| Soubor odmítnut | Větší než 15 MB nebo neuložený jako CSV v kódování UTF-8 | Rozdělte soubor podle produktů a znovu uložte jako CSV v kódování UTF-8 |
| Sloupec ignorován | Záhlaví s překlepem nebo jinými velkými písmeny | Zkopírujte záhlaví z čerstvého exportu |
| Varianty po aktualizaci zmizely | Sloupce variant odeslány bez Option1 name a value | Znovu naimportujte se zahrnutými sloupci možností |
| Aplikace ztratily přehled o variantách | Hodnota možnosti byla přejmenována a vznikla nová ID variant | Hodnoty možností přejmenovávejte záměrně a dotčené aplikace znovu propojte |
| Produkty chybně rozděleny nebo sloučeny | URL handle se mezi řádky jednoho produktu liší | Používejte jeden totožný handle pro každý produkt |
| Chybějící obrázky | Adresa URL není veřejná, není přímým odkazem na soubor nebo vypršela | Umístěte obrázky na stabilní veřejné adresy URL |
| Kategorie nenastavena | Cesta kategorie s překlepem nebo zadána cesta i ID | Použijte právě jedno z nich, zkopírované z taxonomie |
| Čárový kód nepřijat | Délka neodpovídá uvedenému typu | GTIN: 8, 12, 13 nebo 14 číslic; UPC: 8 nebo 12; EAN: 8 nebo 13 |
| Chybějící hodnoty metafields | Špatný formát záhlaví nebo metafield varianty | Použijte Název (product.metafields.namespace.key); metafields variant nastavte jinde |
Často kladené otázky
- Jak hromadně nahrát produkty do Shopify zdarma?
- Použijte vestavěný import CSV v části „Products → Import“. Je součástí každého tarifu Shopify a zpracuje produkty, varianty a obrázky ze souboru CSV ve formátu Shopify.
- Lze nahrát produkty do Shopify z Excelu?
- Nativní importér vyžaduje CSV, proto tabulku z Excelu uložte jako CSV v kódování UTF-8 s názvy sloupců podle Shopify. Některé importní aplikace umí číst soubory Excelu přímo.
- Přepíše import CSV mé existující produkty?
- Existující produkty se aktualizují pouze tehdy, když zvolíte možnost přepsání produktů se shodným handle. Před potvrzením zkontrolujte náhled importu a nejprve vyzkoušejte malý soubor.
- Proč se mi neimportují obrázky?
- Adresy URL obrázků musí být veřejně dostupné přímé odkazy na soubory obrázků. Odkazy, které vyžadují přihlášení, přesměrovávají na webovou stránku nebo pocházejí z dočasného sdílení souborů, obvykle selžou.
- Které sloupce jsou v produktovém CSV pro Shopify povinné?
- K vytvoření produktu je povinný pouze sloupec Title, u variant navíc URL handle. Chcete-li aktualizovat existující produkty, uveďte URL handle a Title. Vše ostatní je volitelné, i když použitelná nabídka obvykle potřebuje cenu, SKU, kategorii, popis a obrázky.
- Kolik variant může mít produkt na Shopify?
- Až 2 048 variant až se třemi volbami. Shopify zvýšilo limit ze 100 v říjnu 2025, takže starší šablony a návody, které uvádějí 100, jsou zastaralé.
- Lze pomocí CSV pro Shopify importovat metafields?
- Metafields produktu ano: přidejte sloupec s hlavičkou Name (product.metafields.namespace.key). Metafields variant produktové CSV nepodporuje a je nutné je nastavit v administraci, pomocí aplikace nebo přes API.
- Jaká je maximální velikost produktového CSV pro Shopify?
- Produktové CSV nesmí překročit 15 MB. Větší katalogy rozdělte do několika souborů a všechny řádky jednoho produktu ponechte ve stejném souboru.