Poradnik
Jak masowo importować produkty do Shopify
Shopify potrafi tworzyć lub aktualizować wiele produktów naraz z pliku CSV. Oto jak działa import, gdzie bywa trudny i co zrobić, gdy dane produktów zaczynają życie w plikach PDF dostawców.
Import produktów z pliku CSV w Shopify to standardowy sposób dodawania katalogu zbiorczo. Przygotowujesz arkusz w formacie Shopify, przesyłasz go w panelu administracyjnym, a Shopify tworzy produkty, warianty i zdjęcia.
Jak przy każdym imporcie, powodzenie zależy od danych, które wprowadzisz. Ten poradnik omawia proces CSV, alternatywy i przygotowania, które oszczędzą Ci porządkowania setek produktów po fakcie.
Opcja 1: import produktów z CSV w panelu Shopify
W panelu administracyjnym Shopify przejdź do Produkty i wybierz Importuj. Prześlij plik CSV w formacie produktów Shopify, zdecyduj, czy produkty o pasujących uchwytach (handle) mają zostać nadpisane, obejrzyj podgląd i potwierdź. Shopify przetwarza plik w tle i powiadamia, gdy skończy.
- Zacznij od przykładowego szablonu CSV produktów Shopify lub wyeksportuj istniejący produkt, aby zobaczyć dokładne kolumny.
- Kolumna URL handle (w starszych szablonach Handle) identyfikuje produkt; wiersze o tym samym handle to warianty lub dodatkowe zdjęcia tego samego produktu.
- Typowe kolumny to Title, Description (Body (HTML)), Vendor, Product category, Type, Tags, Status, Option1 name / Option1 value, SKU (Variant SKU), Price, Barcodes (Variant Barcode) oraz Product image URL (Image Src).
- Zdjęcia są pobierane z publicznych adresów URL w momencie importu.
- Zapisz plik jako CSV w kodowaniu UTF-8, aby zachować znaki specjalne.
Prawidłowa obsługa wariantów
Warianty sprawiają kłopot przy większości pierwszych importów. Każdy produkt może mieć do trzech opcji (na przykład rozmiar, kolor, materiał). Pierwszy wiersz produktu zawiera pola na poziomie produktu i nazwy opcji; każdy kolejny wiersz z tym samym uchwytem dodaje jeden wariant z jego wartościami opcji, SKU, ceną i zapasem.
Zachowaj identyczne nazwy opcji we wszystkich wierszach i unikalną kombinację wartości opcji dla każdego wariantu, aby każdy wiersz odpowiadał dokładnie jednemu wariantowi. Wiersz z kolumnami wariantu, ale bez Option1 name i Option1 value powoduje, że Shopify tworzy wariant domyślny i usuwa istniejące.
Opcja 2: aplikacje do importu zbiorczego
Aplikacje importu ze sklepu Shopify App Store rozszerzają natywny CSV: obsługa Excela i Arkuszy Google, metapola, zaplanowane importy z plików produktowych dostawców oraz migracja z innych platform. Warto je rozważyć, gdy importujesz wielokrotnie lub potrzebujesz pól, których standardowy CSV nie obejmuje.
Opcja 3: Shopify Admin API
Aplikacje i niestandardowe integracje mogą tworzyć produkty przez Admin API Shopify zamiast pliku CSV. Całkowicie eliminuje to przekładanie danych przez arkusze i tak wiele narzędzi do katalogów i ofert tworzy produkty w Shopify.
Doc2Shelf wybiera tę drogę: łączysz sklep przez OAuth, a zweryfikowane oferty są tworzone jako produkty robocze (draft) ze zdjęciami, cenami i kategoriami.
Przygotowanie danych produktów dla Shopify
Przed każdym importem zbiorczym sprawdź, czy:
- Każdy produkt ma unikalny uchwyt (handle), a każdy wariant unikalny SKU.
- Tytuły mają jeden wzorzec (na przykład marka + produkt + kluczowy atrybut).
- Opisy to Twoje własne teksty, a nie wklejony tekst dostawcy, i używają prostego HTML.
- Specyfikacje używają spójnych jednostek i nazw, aby mogły stać się opcjami, tagami lub metapolami.
- Produkty są najpierw importowane jako nieopublikowane, aby można było sprawdzić próbkę przed uruchomieniem.
Gdy dane produktów pochodzą z plików PDF dostawców
Import CSV zakłada, że masz już czyste, ustrukturyzowane dane. Gdy dostawcy przesyłają karty specyfikacji i katalogi jako pliki PDF, ktoś musi najpierw wyodrębnić tytuły, specyfikacje i identyfikatory oraz napisać opisy — zwykle to najwolniejsza część całego zadania.
Doc2Shelf zastępuje ten krok: odczytuje pliki PDF dostawców, wyodrębnia dane produktowe wraz z informacją o pewności do weryfikacji, tworzy wersje robocze tekstów ofert Shopify i tworzy zweryfikowane produkty w połączonym sklepie jako wersje robocze, bez pliku CSV.
Kolumny CSV produktów Shopify: nazwy aktualne i starsze odpowiedniki
Shopify zmieniło nazwy kilku kolumn CSV produktów. Jego aktualna dokumentacja CSV używa etykiet takich jak URL handle, Description, SKU i Barcodes, podczas gdy wiele szablonów i samouczków nadal pokazuje Handle, Body (HTML), Variant SKU i Image Src. Shopify podaje, że zachowuje zgodność wsteczną ze starszymi nazwami kolumn, więc starszy plik nadal się zaimportuje — ale świeży eksport używa aktualnych etykiet, a plik mieszający oba style trudno sprawdzić.
Tabela obejmuje kolumny potrzebne w większości zbiorczych przesyłań. Zmiana nazwy z Barcode na Barcodes jest podana w dokumentacji Shopify; pozostałe starsze etykiety dopasowano według tego, co zawiera dane pole, więc potwierdź je z eksportem z własnego sklepu. W nagłówkach rozróżniana jest wielkość liter.
| Aktualna kolumna | Co zawiera | Przykład | Starsza etykieta lub uwagi |
|---|---|---|---|
| Title | Nazwa produktu | Czajnik ze stali nierdzewnej 1,7 L | Wymagane do utworzenia produktu. |
| URL handle | Unikalny identyfikator produktu używany w adresie URL produktu | steel-kettle | Starsze szablony nazywają ją Handle. Wiersze o tym samym handle należą do jednego produktu. |
| Description | Opis produktu | Bezprzewodowy czajnik z… | Starsze szablony nazywają ją Body (HTML). |
| Vendor | Marka lub producent | Acme | — |
| Product category | Kategoria ze Standard Product Taxonomy | hg-15-1-2 | Pełna ścieżka kategorii lub identyfikator kategorii, nie oba naraz. |
| Type | Twój własny typ produktu | Czajnik elektryczny | Dowolny tekst, w przeciwieństwie do kategorii. |
| Tags | Tagi oddzielone przecinkami | bezprzewodowy, kuchnia | Do 250 tagów na produkt. |
| Status | Status produktu | draft | Zaimportuj jako wersję roboczą, zweryfikuj, a następnie aktywuj. |
| SKU | Variant SKU | KTL-SLV | Starsze szablony nazywają ją Variant SKU. |
| Barcodes | Kody kreskowe wariantu | gtin:4006381333931 | Wcześniej Barcode (a jeszcze wcześniej Variant Barcode). Kilka kodów oddziel średnikami; prefiks typu jest opcjonalny. |
| Option1 name / Option1 value | Pierwsza opcja i wartość tego wariantu | Kolor / Srebrny | Option2 i Option3 działają tak samo. |
| Option1 LinkedTo | Powiązanie opcji z metapolem kategorii | product.metafields.shopify.[attribute] | Opcjonalne; zobacz sekcję o taksonomii poniżej. |
| Price / Compare-at price | Cena sprzedaży i cena porównawcza | 49.90 / 59.90 | Kolumny Price / [Market] zawierają ceny specyficzne dla rynku. |
| Inventory quantity | Stan magazynowy | 25 | Działa z kolumną Inventory tracker. |
| Weight value (grams) | Waga wariantu w gramach | 1200 | Starsze szablony nazywają ją Variant Grams. Weight unit for display ustawia jednostkę widoczną dla kupujących. |
| Product image URL | Publiczny adres URL zdjęcia produktu | https://cdn.example.com/kettle.jpg | Starsze szablony nazywają ją Image Src. |
| Image position / Image alt text | Kolejność w galerii i tekst alternatywny | 1 / Czajnik stalowy, widok z przodu | Tekst alternatywny do 512 znaków. |
| Variant image URL | Zdjęcie wyświetlane po wybraniu tego wariantu | https://cdn.example.com/kettle-black.jpg | — |
| SEO title / SEO description | Tytuł i meta opis dla wyników wyszukiwania | — | Do 70 i 320 znaków. |
| Kolumny metapól | Wartości metapól produktu | Material (product.metafields.custom.material) | Format nagłówka: Nazwa (product.metafields.namespace.key). |
Warianty i opcje: limity i pułapki
Produkt Shopify może mieć do trzech opcji — na przykład Rozmiar, Kolor i Materiał — oraz do 2048 wariantów. Limit wariantów wynosił 100, dopóki Shopify nie podniosło go w październiku 2025 r., więc szablony i poradniki napisane wcześniej nadal podają starą liczbę. Niektóre motywy, aplikacje i kanały sprzedaży zbudowano z myślą o starym limicie, więc sprawdź swoje, zanim zaimportujesz produkt z setkami wariantów.
Pierwszy wiersz produktu zawiera pola na poziomie produktu i nazwy opcji. Każdy kolejny wiersz z tym samym URL handle dodaje jeden wariant z wartością opcji, SKU, ceną, wagą i stanem magazynowym, a pola na poziomie produktu pozostawia puste.
Dwa zachowania zaskakują przy imporcie aktualizacji. Jeśli wiersz zawiera kolumny wariantu, takie jak SKU lub waga, ale pomija Option1 name i Option1 value, Shopify tworzy wariant domyślny i usuwa istniejące warianty. A zmiana wartości opcji — na przykład „Grey” na „Gray” — usuwa identyfikatory wariantów i tworzy nowe, co może zepsuć aplikacje i feedy odwołujące się do tych identyfikatorów.
| Wiersz | URL handle | Title | Option1 name | Option1 value | SKU |
|---|---|---|---|---|---|
| Pierwszy wiersz | steel-kettle | Czajnik stalowy | Kolor | Srebrny | KTL-SLV |
| Kolejny wiersz | steel-kettle | (puste) | (puste) | Czarny | KTL-BLK |
Zdjęcia produktów w pliku CSV Shopify
Shopify pobiera zdjęcia z kolumny Product image URL podczas importu, więc każdy adres URL musi być publicznie dostępny i wskazywać bezpośrednio plik zdjęcia. Linki wymagające logowania, otwierające stronę podglądu lub wygasające przed uruchomieniem importu to częste powody, dla których zdjęcia znikają.
Produkt może mieć do 250 zdjęć lub innych multimediów. Pierwsze zdjęcie umieść w pierwszym wierszu produktu; każde kolejne dodaj w osobnym wierszu z tym samym URL handle, adresem URL zdjęcia, Image position i Image alt text. Aby po wybraniu wariantu przez kupującego wyświetlało się konkretne zdjęcie, wpisz jego adres URL w Variant image URL w wierszu tego wariantu.
Tekst alternatywny może mieć do 512 znaków, a Shopify zaleca 125 lub mniej. Opisz, co pokazuje zdjęcie — „Czajnik ze stali nierdzewnej, widok z przodu ze wskaźnikiem poziomu wody” — zamiast powtarzać tytuł produktu.
Kategoria produktu, metapola i Standard Product Taxonomy
Kolumna Product category przypisuje kategorię ze Standard Product Taxonomy Shopify, wybraną według głównej funkcji produktu. Wpisz pełną ścieżkę, np. Home & Garden > Linens & Bedding > Bedding > Bed Sheets, albo identyfikator kategorii, np. hg-15-1-2 — nie oba naraz. Produkt bez kategorii jest traktowany jako niekategoryzowany.
Ustawienie kategorii odblokowuje jej metapola kategorii, które taksonomia nazywa atrybutami produktu. Kategoria Shirts w Shopify ma ich na przykład dziewięć, w tym rozmiar, dekolt, tkaninę i kolor, a wartości koloru mogą wyświetlać się jako próbki. Kolumna Option1 LinkedTo łączy opcję wariantu z jednym z tych metapól kategorii.
Kategoria ma znaczenie nie tylko dla nawigacji: Shopify Tax używa jej do ustalania stawek podatkowych. Type to natomiast dowolna etykieta, którą definiujesz sam, przydatna do własnych filtrów i raportów.
Niestandardowe metapola produktu importuje się przez kolumny z nagłówkiem Nazwa (product.metafields.namespace.key), na przykład Material (product.metafields.custom.material). Metapola wariantów nie są obsługiwane w CSV produktów, więc ustaw je w panelu administracyjnym, za pomocą aplikacji lub przez API.
Limity CSV w Shopify i długości pól SEO
Oto limity, które Shopify dokumentuje dla importów CSV produktów i rekordów produktów. Liczby w starszych poradnikach — zwłaszcza limit 100 wariantów — są nieaktualne.
Kolumny SEO title i SEO description wypełniają tytuł i meta opis używane w wynikach wyszukiwania. Pisz je dla każdego produktu osobno, zamiast kopiować jeden wzorzec na cały katalog: zacznij od nazwy produktu i atrybutu, którego szukają kupujący, takiego jak rozmiar, materiał lub numer modelu.
| Pozycja | Limit | Co zrobić |
|---|---|---|
| Rozmiar pliku CSV | 15 MB | Podziel duże katalogi; wszystkie wiersze produktu trzymaj w jednym pliku. |
| Opcje na produkt | 3 | Dalsze różnice modeluj jako osobne produkty lub metapola. |
| Warianty na produkt | 2048 | Sprawdź, czy motyw i aplikacje radzą sobie z dużą liczbą wariantów. |
| Zdjęcia i multimedia na produkt | 250 | Ogranicz galerię do zdjęć, które pomagają kupującym podjąć decyzję. |
| Tagi na produkt | 250 | Używaj tagów do filtrowania i automatyzacji. |
| Kody kreskowe na produkt lub wariant | 20 | Dodaj prefiks typu, np. gtin:, jeśli znasz typ. |
| Tytuł SEO | 70 znaków | Zacznij od nazwy produktu i kluczowego atrybutu. |
| Opis SEO | 320 znaków | Podsumuj produkt, umieszczając kluczowe szczegóły na początku. |
| Tekst alternatywny zdjęcia | 512 znaków (zalecane 125 lub mniej) | Opisz, co pokazuje zdjęcie. |
Nadpisanie czy utworzenie: jak działają aktualizacje
Aby utworzyć produkt, CSV potrzebuje tylko Title; dodanie wariantów wymaga również URL handle. Aby zaktualizować istniejący produkt, Shopify potrzebuje URL handle i Title, a podczas rozpoczynania importu wybierasz nadpisywanie produktów o pasujących handle.
Traktuj nadpisanie jako rozstrzygające dla każdej dołączonej kolumny. Najbezpieczniejszy schemat to eksport, edycja, ponowny import: wyeksportuj produkty, które chcesz zmienić, edytuj tylko komórki wymagające zmiany, zachowaj kolumny opcji na miejscu i zaimportuj edytowany plik z włączonym nadpisywaniem. Rzadki plik zbudowany od zera łatwo uruchamia opisane wyżej usuwanie wariantów.
Przed zatwierdzeniem przeczytaj podgląd importu, a dużą aktualizację najpierw uruchom na kilku produktach. Eksport wykonany przed edycją to Twoja droga powrotu, jeśli coś pójdzie nie tak.
Lista kontrolna przed importem i rozwiązywanie problemów
Przejdź przez te kroki przed dużym importem; tabela po nich obejmuje najczęstsze problemy.
- Wyeksportuj jeden produkt ze sklepu i użyj jego wiersza nagłówka, aby nazwy kolumn dokładnie się zgadzały.
- Nadaj każdemu produktowi unikalny URL handle, a każdemu wariantowi unikalny SKU.
- Sprawdź spójność pisowni nazw i wartości opcji i upewnij się, że każdy wiersz wariantu ma wartość opcji.
- Wypełnij Product category ścieżką lub identyfikatorem skopiowanym z taksonomii.
- Otwórz próbkę adresów URL zdjęć w oknie prywatnym przeglądarki, aby potwierdzić, że ładują się bez logowania.
- Przy pierwszym uruchomieniu ustaw Status na draft.
- Zapisz jako CSV w UTF-8 i potwierdź, że plik ma mniej niż 15 MB.
- Zaimportuj pięć do dziesięciu produktów, sprawdź je w panelu administracyjnym i na stronie sklepu, a następnie zaimportuj resztę.
| Problem | Prawdopodobna przyczyna | Rozwiązanie |
|---|---|---|
| Plik odrzucony | Większy niż 15 MB lub niezapisany jako CSV w UTF-8 | Podziel plik według produktów i zapisz ponownie jako CSV w UTF-8 |
| Kolumna zignorowana | Nagłówek z błędem pisowni lub inną wielkością liter | Skopiuj nagłówki ze świeżego eksportu |
| Warianty zniknęły po aktualizacji | Kolumny wariantu wysłane bez Option1 name i value | Zaimportuj ponownie z dołączonymi kolumnami opcji |
| Aplikacje straciły ślad wariantów | Zmieniono nazwę wartości opcji, co utworzyło nowe identyfikatory wariantów | Zmieniaj nazwy wartości opcji świadomie i ponownie połącz dotknięte aplikacje |
| Produkty błędnie rozdzielone lub scalone | URL handle różni się w wierszach jednego produktu | Użyj jednego identycznego handle dla produktu |
| Brakujące zdjęcia | Adres URL niepubliczny, nie bezpośredni link do pliku lub wygasły | Hostuj zdjęcia pod stabilnymi publicznymi adresami URL |
| Kategoria nie ustawiona | Błędnie wpisana ścieżka lub podano jednocześnie ścieżkę i identyfikator | Użyj dokładnie jednego, skopiowanego z taksonomii |
| Kod kreskowy nie został zaakceptowany | Długość nie pasuje do podanego typu | GTIN: 8, 12, 13 lub 14 cyfr; UPC: 8 lub 12; EAN: 8 lub 13 |
| Brakujące wartości metapól | Zły format nagłówka lub metapole wariantu | Użyj formatu Nazwa (product.metafields.namespace.key); metapola wariantów ustawiaj gdzie indziej |
Najczęściej zadawane pytania
- Jak masowo zaimportować produkty do Shopify za darmo?
- Użyj wbudowanego importu CSV w menu Produkty → Importuj. Jest dostępny w każdym planie Shopify i obsługuje produkty, warianty oraz zdjęcia z pliku CSV w formacie Shopify.
- Czy mogę przesłać produkty do Shopify z Excela?
- Natywny importer wymaga CSV, więc zapisz arkusz Excela jako CSV w UTF-8 z nazwami kolumn Shopify. Niektóre aplikacje importu potrafią odczytywać pliki Excela bezpośrednio.
- Czy import CSV nadpisze moje istniejące produkty?
- Istniejące produkty są aktualizowane tylko wtedy, gdy wybierzesz opcję nadpisania produktów o pasujących uchwytach. Przed potwierdzeniem obejrzyj podgląd importu i najpierw przetestuj na małym pliku.
- Dlaczego moje zdjęcia się nie importują?
- Adresy URL zdjęć muszą być publicznie dostępnymi, bezpośrednimi linkami do plików graficznych. Linki wymagające logowania, przekierowujące na stronę internetową lub pochodzące z tymczasowego udostępnienia plików zwykle nie działają.
- Które kolumny są wymagane w pliku CSV produktów Shopify?
- Do utworzenia produktu wymagany jest tylko Title, a przy dodawaniu wariantów także URL handle. Aby zaktualizować istniejące produkty, uwzględnij URL handle i Title. Wszystko inne jest opcjonalne, choć użyteczna oferta zwykle wymaga ceny, SKU, kategorii, opisu i zdjęć.
- Ile wariantów może mieć produkt w Shopify?
- Do 2048 wariantów w maksymalnie trzech opcjach. Shopify podniosło limit ze 100 w październiku 2025 r., więc starsze szablony i poradniki podające 100 są nieaktualne.
- Czy mogę importować metapola przez plik CSV Shopify?
- Metapola produktów — tak: dodaj kolumnę z nagłówkiem Name (product.metafields.namespace.key). Metapola wariantów nie są obsługiwane w pliku CSV produktów i trzeba je ustawić w panelu administracyjnym, za pomocą aplikacji lub przez API.
- Jaki jest maksymalny rozmiar pliku CSV produktów w Shopify?
- Plik CSV produktów nie może przekraczać 15 MB. Większe katalogi podziel na kilka plików i trzymaj wszystkie wiersze jednego produktu w tym samym pliku.