Plik z produktami do importu w PrestaShop - jak go przygotować

Publikacja: 15 września 2026 · Grzegorz Rapczyński

Dobrze przygotowany plik potrafi obciąć koszt wdrożenia o kilkanaście godzin pracy. Wprowadzenie produktu ręcznie to kilkanaście minut pracy razem ze zdjęciami, opisem, cechami i przypisaniem do kategorii. Import 500 produktów z poprawnego pliku to jedna operacja i godzina na sprawdzenie wyniku. Ta różnica jest całkowicie po Twojej stronie - i dlatego warto poświęcić na plik jeden wieczór. Poniżej opisuję, jak taki plik ma wyglądać dla sklepu na PrestaShop.

Format pliku: CSV, XLSX czy XML

Najlepszy jest CSV w kodowaniu UTF-8. Jest prosty, przewidywalny i czyta go każde narzędzie. Przy zapisie z arkusza kalkulacyjnego wybierz opcję „CSV UTF-8”, a nie zwykłe CSV - to jedyna różnica między plikiem z polskimi znakami a plikiem pełnym krzaczków.

XLSX też jest w porządku i dla wielu osób wygodniejszy, bo nie trzeba niczego eksportować. Ma jednak jedną pułapkę, o której piszę niżej: arkusz sam „poprawia” niektóre dane i potrafi zepsuć kody EAN oraz ceny.

XML ma sens wtedy, gdy dostajesz go gotowego z hurtowni albo z poprzedniego sklepu. Nie ma powodu, żeby tworzyć go ręcznie.

Zasady wspólne dla wszystkich formatów:

• Pierwszy wiersz to nagłówki kolumn, dalej same dane. Bez tytułu tabeli nad nagłówkami, bez pustych wierszy w środku, bez podsumowania na dole.
• Jeden arkusz, nie pięć zakładek z różnymi grupami produktów.
• Bez scalonych komórek, kolorowania jako sposobu oznaczania i komentarzy. To wszystko ginie przy eksporcie.
• Jedna informacja w jednej kolumnie. „Koszulka czerwona XL 49 zł” w jednym polu trzeba i tak rozdzielić ręcznie.

Kolumny obowiązkowe

Bez tych sześciu nie da się zrobić poprawnego produktu:

Przesuń tabelę w bok, żeby zobaczyć pozostałe kolumny

Kolumny, które bardzo pomagają

Nie są konieczne do uruchomienia sklepu, ale każda z nich oszczędza późniejszą pracę - Twoją albo moją:

• Opis krótki - dwa, trzy zdania pokazywane na liście i u góry karty produktu.
• Opis pełny - właściwa treść karty. Jeśli go nie masz, sklep i tak ruszy, ale puste karty słabo sobie radzą w wyszukiwarce. Jak pisać, żeby miało to sens, opisałem w artykule o opisach produktów pod SEO.
• EAN - niezbędny przy sprzedaży na porównywarkach i marketplace. Uwaga na arkusz, który zjada zero na początku.
• Producent / marka - pozwala zbudować filtr po marce i strony marek.
• Waga w kilogramach - bez niej nie policzysz kosztu dostawy zależnego od wagi.
• Cechy - materiał, kolor, przeznaczenie, moc. To z nich powstają filtry na liście produktów. Każda cecha w osobnej kolumnie, nie wszystkie w jednym worku.
• Tytuł i opis meta - jeśli je masz, wchodzą od razu. Jeśli nie, generuje się je później.
• Adresy zdjęć - o tym za chwilę.

Zasada, którą powtarzam każdemu klientowi: lepiej mieć 40 produktów opisanych porządnie niż 400 z samą nazwą i ceną. Puste karty nie sprzedają i nie wchodzą do wyszukiwarki, a poprawianie ich po imporcie kosztuje więcej niż zrobienie tego od razu w pliku.

Kategorie

Kategorię zapisuje się jako pełną ścieżkę od góry drzewa, z jednym stałym separatorem w całym pliku:

Odzież > Koszulki > Z krótkim rękawem

Dwie rzeczy, na które warto uważać:

• Pisownia musi być identyczna w każdym wierszu. „Odzież” i „odzież” to dla importu dwie różne kategorie i po imporcie masz dwa drzewa zamiast jednego.
• Produkt w kilku kategoriach - wtedy kilka ścieżek w jednej komórce, rozdzielonych innym znakiem niż ten w ścieżce, na przykład średnikiem. Ważne, żeby ten drugi znak nie występował w nazwach kategorii.

Dobry moment, żeby przy okazji uporządkować strukturę. Kategoria, w której leży 300 produktów bez podziału, jest nie do przejrzenia dla klienta. Kategoria z dwoma produktami jest zbędna.

Warianty - najtrudniejsza część

Tu powstaje najwięcej nieporozumień, więc najpierw rozróżnienie:

• Cecha to informacja opisowa, taka sama dla całego produktu: materiał bawełna, kraj produkcji Polska. Klient jej nie wybiera.
• Wariant to coś, co klient wybiera w koszyku i co ma własny stan magazynowy oraz często własną cenę: rozmiar, kolor, pojemność.

Wariant zapisuje się tak, że każda kombinacja dostaje własny wiersz. Koszulka w trzech rozmiarach i dwóch kolorach to sześć wierszy. Wszystkie mają tę samą nazwę produktu i tę samą kolumnę grupującą, a różnią się referencją, wartościami wariantu, stanem i ewentualnie ceną.

Przesuń tabelę w bok, żeby zobaczyć pozostałe kolumny

Czego nie robić: nie wpisuj wariantów po przecinku w jednej komórce („S, M, L, XL”). Taki zapis nie niesie informacji o stanach ani cenach poszczególnych rozmiarów i i tak trzeba go rozbić ręcznie. To jest dokładnie ten moment, w którym tani import zamienia się w drogie klepanie.

Zdjęcia

Dwie drogi, obie działają:

• Adresy w pliku. Kolumna ze pełnymi adresami zdjęć, kilka w jednej komórce rozdzielonych stałym znakiem. Pierwszy adres to zdjęcie główne. Najwygodniejsze, gdy zdjęcia są już gdzieś w sieci, na przykład u hurtownika.
• Paczka plików. Archiwum, w którym nazwa pliku odpowiada referencji produktu: KOSZ-CZE-XL_1.jpg, KOSZ-CZE-XL_2.jpg. Numer na końcu ustala kolejność.

Czego unikać: nazw typu IMG_20260418_113402.jpg bez żadnej listy przypisań. Wtedy ktoś musi otworzyć każde zdjęcie i zgadnąć, do czego należy - i za to się płaci osobno.

Rozmiary, formaty i wagę zdjęć opisałem osobno w tekście o zdjęciach produktów do sklepu. W skrócie: wgrywaj oryginały w rozsądnej rozdzielczości, resztę zrobi sklep.

Osobna sprawa to import, który w ogóle nie dochodzi do końca - zatrzymuje się w połowie i zostawia katalog w połowicznym stanie. Przyczyny i sposób postępowania zebrałem w tekście o tym, dlaczego import produktów się przerywa.

Najczęstsze błędy

• Przecinek zamiast kropki w cenie. „39,90” w pliku CSV, w którym przecinek rozdziela kolumny, rozjeżdża cały wiersz.
• Arkusz zjada zero na początku. Kod EAN „0590123456789” zamienia się w „590123456789”. Kolumnę z EAN-ami ustaw jako tekstową, zanim cokolwiek do niej wkleisz.
• Cena z walutą. „39,90 zł” to tekst, nie liczba.
• Krzaczki zamiast polskich znaków. Efekt zapisu w złym kodowaniu. Zawsze UTF-8.
• Powtórzone referencje. Dwa produkty o tym samym SKU - drugi nadpisuje pierwszy albo import się zatrzymuje.
• Kod HTML z poprzedniego sklepu w opisach. Style i klasy ze starego szablonu rozjeżdżają wygląd na nowym. Lepiej wyczyścić przed importem niż poprawiać 300 kart po.
• Cena raz netto, raz brutto. Zdarza się, gdy plik powstawał z dwóch źródeł. Efekt: część asortymentu droższa o 23%.
• Puste pole stanu magazynowego tam, gdzie miało być „dostępny”. Produkt wchodzi do sklepu jako niedostępny i nikt tego nie zauważa do pierwszej reklamacji.
• Spacje na końcu wartości. „Odzież ” i „Odzież” to dwie różne kategorie. Warto przed wysłaniem przepuścić plik przez funkcję usuwania zbędnych spacji.

Jeśli po imporcie część produktów nie pokazuje się w sklepie, najczęściej chodzi o brakującą kolumnę w pliku. Przyczyny po kolei zebrałem w tekście produkt nie wyświetla się w sklepie.

Zanim wyślesz plik

1. Posortuj po referencji i sprawdź, czy nie ma powtórek.
2. Włącz filtry na nagłówkach i przejrzyj listę unikalnych wartości w kolumnach kategorii, rozmiaru i koloru. Literówki i różne warianty pisowni wyskakują wtedy natychmiast.
3. Sprawdź skrajne ceny - najniższą i najwyższą. To najszybszy sposób na wyłapanie przecinka w złym miejscu.
4. Policz wiersze i zapisz tę liczbę. Po imporcie musi się zgadzać.
5. Wyślij najpierw 20 wierszy. Zawsze zaczynam od próbnej partii: wgrywam dwadzieścia produktów, oglądasz, jak wyglądają w sklepie, i dopiero potem idzie całość. Poprawka w pliku zajmuje minutę, poprawka w 800 zaimportowanych produktach cały dzień.

Dwie kolumny sprawiają przy imporcie najwięcej kłopotu. Pierwsza to podatek, gdzie trzeba podać identyfikator reguły podatkowej, a nie stawkę. Druga to parametry produktu - zanim je wpiszesz, warto zdecydować, co ma być cechą, a co atrybutem.

Najczęstsze pytania

Nie mam pliku, mam produkty w starym sklepie. Co teraz?

Prawie każda platforma ma eksport do CSV albo XML i to jest najlepszy punkt wyjścia - dane są kompletne i spójne. Opisuję to szerzej na stronie migracji sklepu.

Mam plik od hurtowni. Wystarczy?

Zwykle tak, choć często wymaga przemapowania kategorii na Twoje i wyczyszczenia opisów. Jeśli planujesz stałą synchronizację stanów i cen, to osobny temat niż jednorazowy import i wyceniam go oddzielnie.

Ile produktów opłaca się wprowadzić ręcznie?

Granica leży mniej więcej przy trzydziestu. Poniżej tej liczby przygotowanie pliku zajmuje tyle co samo wpisanie. Powyżej - plik wygrywa i to z dużym zapasem. W kalkulatorze wyceny możesz zobaczyć obie kwoty obok siebie.

Czy mogę dosyłać produkty partiami?

Tak, to normalna praktyka. Ważne, żeby kolumny w każdej partii były takie same - wtedy kolejny import to rutyna, a nie nowa układanka.

Co z produktami, które mają różne ceny dla firm?

Ceny dla grup klientów to osobny mechanizm i osobna kolumna albo osobny plik. Powiedz o tym przed przygotowaniem pliku, bo wpływa na jego układ.

Prześlij plik, sprawdzę go

Jeśli nie masz pewności, czy Twój plik nadaje się do importu, wyślij go - przejrzę i napiszę, co poprawić, zanim zaczniesz uzupełniać setki wierszy. Formularz kontaktowy, 881 932 088 lub kontakt@grvision.pl.