Import produktów do Shopify z CSV - format pliku, warianty i najczęstsze błędy importu

Warianty w imporcie CSV do Shopify - jak ułożyć wiersze

Produkt z wariantami zajmuje w pliku tyle wierszy, ile ma wariantów. Pierwszy wiersz zawiera pełne dane produktu: tytuł, opis, producenta, tagi, kategorię i dane pierwszego wariantu. W kolejnych wierszach wpisujesz ten sam URL handle, wartości opcji i dane wariantu, a kolumny Title, Description, Vendor i Tags zostawiasz puste. Produkt może mieć do trzech opcji i do 2 048 wariantów (stan na lipiec 2026 - sprawdź aktualne zasady). Każda kombinacja wartości opcji musi być w obrębie produktu unikalna.

[#przyklad] Koszulka w dwóch kolorach i trzech rozmiarach to sześć wierszy z tym samym URL handle, np. koszulka-basic. Pierwszy wiersz ma tytuł, opis, kategorię, Option1 name = Kolor, Option1 value = Czarny, Option2 name = Rozmiar, Option2 value = S oraz SKU i cenę. Pozostałe pięć wierszy ma tylko uchwyt, kolejne pary wartości opcji (Czarny M, Czarny L, Biały S, Biały M, Biały L), SKU, cenę i stan.

Zanim zbudujesz plik, zaplanuj nazwy opcji i wartości dla całego katalogu: jeden zapis rozmiarów, jedna lista kolorów, ta sama kolejność opcji w każdym produkcie. O tym, jak ułożyć opcje pod filtry i feedy, piszemy szerzej we wpisie warianty produktów w Shopify - opcje, limity i planowanie katalogu. W imporcie liczy się szczególnie stabilność: pomoc Shopify podaje, że zmiana wartości w kolumnach Option1 value, Option2 value lub Option3 value usuwa dotychczasowe identyfikatory wariantów i tworzy nowe. Może to zerwać powiązania w aplikacjach zewnętrznych, np. w integratorze, programie do faktur czy aplikacji do feedów.

Duże sklepy muszą też uwzględnić limit dzienny. Sklep z co najmniej 500 000 wariantów może utworzyć przez CSV lub API do 10 000 nowych wariantów w ciągu 24 godzin, a okno liczy się od pierwszego wgrania pliku w danym dniu. Limit nie dotyczy planu Shopify Plus (stan na lipiec 2026 - sprawdź aktualne zasady).

Zdjęcia w imporcie produktów do Shopify

Zdjęć nie wgrywasz razem z plikiem. W kolumnie Product image URL podajesz adres zdjęcia, a Shopify pobiera je i zapisuje u siebie. Adres musi być publiczny, dostępny przez https i bez hasła - zdjęcia z dysku firmowego za logowaniem nie zostaną pobrane. Kolumna Image position ustala kolejność zdjęć od 1, a Image alt text zawiera tekst alternatywny, który pomoc Shopify ogranicza do 512 znaków i zaleca do 125. Produkt może mieć do 250 zdjęć (stan na lipiec 2026 - sprawdź aktualne limity).

Kolejne zdjęcia produktu dodajesz w następnych wierszach z tym samym uchwytem, w których wypełniasz tylko kolumny zdjęcia. Zdjęcie konkretnego wariantu, np. czerwonej wersji koszulki, wpisujesz w kolumnie Variant image URL w wierszu tego wariantu. Pomoc Shopify zwraca uwagę na dwie pułapki: pliki wgrane wcześniej do Content > Files zostaną przy imporcie zduplikowane, a sortowanie pliku w arkuszu kalkulacyjnym potrafi rozjechać przypisanie zdjęć do produktów. Jak dobrać zdjęcia i teksty alternatywne, opisujemy we wpisie karta produktu w Shopify - opisy, zdjęcia i metapola.

Jak zaimportować plik CSV do Shopify krok po kroku

Sam import trwa kilka minut, ale warto go poprzedzić testem na kilku produktach. Kolejność kroków według pomocy Shopify jest następująca:

1. W panelu Shopify przejdź do Products i kliknij Import.

2. Kliknij Add file i wybierz plik CSV.

3. Jeśli nowe produkty mają trafić tylko do sklepu internetowego, wyłącz opcję Publish new products to all sales channels.

4. Jeśli aktualizujesz istniejące produkty, włącz Overwrite products with matching handles.

5. Kliknij Upload and continue, sprawdź podsumowanie importu i zatwierdź przyciskiem Import products.

6. Poczekaj na e-mail z potwierdzeniem i sprawdź kilka produktów w panelu oraz w sklepie.

Rozpoczętego importu nie można anulować, a Shopify nie pokazuje listy wcześniejszych importów - zmiany sprawdzisz w dzienniku aktywności sklepu. Dlatego przed dużą aktualizacją zrób eksport produktów jako kopię stanu sprzed zmian. Pomoc Shopify zaleca też przeglądarkę Google Chrome, bo w innych zdarzają się problemy z wgrywaniem pliku.

Najwięcej pytań budzi nadpisywanie. Gdy jest włączone, produkty o tym samym uchwycie zostaną zaktualizowane, a gdy jest wyłączone - wiersze z istniejącymi uchwytami Shopify pominie. Przy nadpisywaniu pusta komórka w kolumnie niewymaganej czyści dotychczasową wartość, a kolumna, której nie ma w pliku, zostaje bez zmian. Kiedy włączyć tę opcję, pokazuje porównanie:

[#chart:shf21c]

Najczęstsze błędy importu CSV w Shopify i jak je naprawić

Gdy import się nie uda, Shopify pokazuje komunikat z numerem wiersza i przyczyną. Większość problemów wynika z kilku powtarzalnych błędów, które zebraliśmy na schemacie:

[#chart:shf21b]

Komunikaty są po angielsku, dlatego poniżej zestawiamy najczęstsze z nich z przyczyną opisaną w pomocy Shopify:

• Invalid CSV header: missing headers - pierwszy wiersz nie odpowiada nagłówkom szablonu albo nagłówki mają spacje na końcu,

• Illegal quoting lub Missing or stray quote - w pliku jest niedozwolony znak, najczęściej zaokrąglony cudzysłów wstawiony przez arkusz,

• Ignored line … because handle already exists - dwa produkty mają ten sam uchwyt albo nadpisywanie jest wyłączone,

• Validation failed: options are not unique - dwa warianty mają tę samą kombinację wartości opcji,

• Validation failed: price can't be blank - w wierszu wariantu brakuje ceny,

• An error occurred while trying to download the image - zdjęcia nie ma pod podanym adresem albo adres nie jest publiczny,

• Not a valid product category - kategoria nie odpowiada dokładnie taksonomii Shopify,

• Line is invalid (No details) - często wartość opcji przeniesiono na inną pozycję opcji; pomoc zaleca import z tymczasową nazwą opcji, a potem ponowny import z docelową.

[#uwaga] Arkusz kalkulacyjny to najczęstsze źródło błędów. Przy zapisie potrafi zmienić kodowanie, separator na średnik i proste cudzysłowy na zaokrąglone, a z kodów EAN usunąć zera z początku. Po eksporcie z arkusza otwórz plik w edytorze tekstu i sprawdź kodowanie UTF-8, przecinki i kilka wierszy z polskimi znakami.

Import CSV, aplikacja czy integrator - co wybrać w Shopify?

Wbudowany import wystarcza do produktów i ich zdjęć wgrywanych od czasu do czasu. Gdy potrzebujesz importować także klientów, zamówienia, przekierowania czy metaobiekty albo chcesz uruchamiać import według harmonogramu, sięgnij po aplikację. Przykładem jest Matrixify: Data Export Import w Shopify App Store, która według swojej karty obsługuje pliki Excel, CSV i Google Sheets oraz importy zaplanowane. Przed wyborem sprawdź na karcie aplikacji aktualny cennik i limity planu.

Trzecia droga to integrator, np. Base, gdy katalog powstaje poza Shopify i trafia także na marketplace'y. Wtedy plik CSV służy raczej do jednorazowego startu, a bieżące dane płyną przez integrację. Podobny dylemat opisujemy z perspektywy WordPressa we wpisie import produktów do WooCommerce z CSV i XML - zasada jest ta sama: im częściej zmieniają się dane, tym bardziej opłaca się automatyzacja zamiast ręcznego pliku.

Jak Vinson pomaga z importem produktów do Shopify

W Vinson wdrażamy sklepy na Shopify, przenosimy je z innych platform i opiekujemy się nimi po starcie. Jesteśmy agencją e-commerce z Bochni, działamy od 2021 r. i współpracowaliśmy z ponad 500 firmami. Przy imporcie produktów zwykle:

• przekształcamy eksport ze starego sklepu, hurtowni lub ERP do szablonu CSV Shopify,

• planujemy opcje, warianty, kategorie i metapola dla całego katalogu,

• przygotowujemy publiczne adresy zdjęć i teksty alternatywne,

• wykonujemy import próbny, poprawiamy błędy i dopiero potem importujemy całość,

• sprawdzamy, czy integracje i feedy widzą produkty po imporcie.

Szczegóły współpracy znajdziesz na stronie sklep na Shopify z Vinson.

Najczęściej zadawane pytania

Jak zaimportować produkty do Shopify z pliku CSV?

W panelu Shopify wejdź w Products, kliknij Import, dodaj plik przyciskiem Add file, a potem kliknij Upload and continue i Import products. Plik musi mieć nagłówki zgodne z szablonem Shopify, przecinki jako separator i kodowanie UTF-8.

Jak dodać warianty produktu w pliku CSV Shopify?

Każdy wariant to osobny wiersz z tym samym URL handle co produkt. Pierwszy wiersz ma pełne dane produktu, a kolejne tylko uchwyt, wartości opcji oraz dane wariantu, takie jak SKU, cena i stan. Kombinacje wartości opcji nie mogą się powtarzać.

Jaki jest maksymalny rozmiar pliku CSV w Shopify?

Według pomocy Shopify plik CSV z produktami nie może przekroczyć 15 MB. Większy katalog podziel na kilka plików i importuj je po kolei. Limit może się zmienić, więc sprawdź go w aktualnej pomocy Shopify.

Dlaczego import CSV w Shopify nie dodaje zdjęć?

Najczęściej adres zdjęcia nie jest publiczny, wymaga logowania albo nie zaczyna się od https. Shopify pobiera zdjęcie z podanego adresu, więc plik musi być dostępny dla każdego. Problem powoduje też sortowanie pliku w arkuszu, które rozdziela zdjęcia od właściwych produktów.

Czy import CSV w Shopify nadpisze istniejące produkty?

Tylko wtedy, gdy włączysz opcję Overwrite products with matching handles. Pusta komórka w kolumnie niewymaganej wyczyści wtedy dotychczasową wartość, a kolumna pominięta w pliku zostanie bez zmian. Przed nadpisaniem zrób eksport produktów jako kopię.

Import produktów do Shopify z CSV jest prosty, gdy plik trzyma się szablonu, warianty mają stabilne opcje, a zdjęcia publiczne adresy. Jeśli przygotowujesz duży katalog albo migrację i chcesz uniknąć poprawiania setek wierszy, sprawdź sklep na Shopify z Vinson - zaczniemy od importu próbnego na kilku produktach.