CSV w WooCommerce potrafi oszczędzić sporo klikania. Zamiast otwierać po kolei każdy produkt, możesz przygotować dane w jednym pliku i wykorzystać wbudowany importer do dodawania, eksportowania albo masowej aktualizacji katalogu. Brzmi dobrze? Brzmi. Ale CSV nie jest magicznym przyciskiem „ogarnij cały sklep”. Jeśli kolumny są pomieszane, SKU nie pasuje, a warianty żyją własnym życiem, narzędzie zrobi dokładnie to, co mu podasz. Nawet jeśli podasz mu bałagan.
W tym artykule przejdziemy przez cały proces: przygotowanie pliku, mapowanie kolumn, zmianę cen i kategorii, pracę z wariantami oraz zdjęciami. Na końcu dostaniesz prostą checklistę kontroli. Opis dotyczy wbudowanego importera i eksportera CSV w WooCommerce, a nie dowolnej płatnej wtyczki, integracji hurtowni czy niestandardowego rozwiązania.
CSV w WooCommerce — co właściwie można nim zrobić?
Import, eksport, aktualizacja i migracja
Wbudowane narzędzie CSV znajdziesz w sekcji Produkty > Wszystkie produkty. Może służyć do kilku różnych zadań. Po pierwsze, pozwala dodać nowe produkty. Po drugie, umożliwia eksport istniejącego katalogu, więc otrzymujesz plik będący punktem wyjścia do dalszej pracy. Po trzecie, pozwala masowo poprawiać dane już obecne w sklepie.
CSV przydaje się także przy migracji produktów WooCommerce między witrynami oraz przy łączeniu danych produktów. To jednak nie oznacza automatycznego przeniesienia całego sklepu. Opisywany proces dotyczy produktów, wariantów, zdjęć i podstawowych danych katalogowych. Nie należy zakładać, że w ten sam sposób przeniesiesz zamówienia, klientów, kupony, płatności albo konfigurację wysyłki.
Najprościej myśleć o tym tak: eksport produktów WooCommerce daje Ci uporządkowaną bazę, plik CSV WooCommerce jest arkuszem roboczym, a importer wykonuje zaplanowaną operację. Im lepiej przygotujesz dane, tym mniej niespodzianek po kliknięciu przycisku.
Zanim klikniesz Import: przygotowanie pliku
Checklista pliku przed wgraniem
Najbezpieczniej zacząć od eksportu istniejącego produktu albo oficjalnego przykładowego pliku, zamiast budować duży arkusz całkowicie od zera. Dzięki temu zachowasz rozpoznawane nazwy kolumn i łatwiej dopasujesz format do WooCommerce. Plik CSV powinien być zapisany w kodowaniu UTF-8. To ważne szczególnie wtedy, gdy w nazwach i opisach występują polskie znaki.
Przed wgraniem przejrzyj plik od początku do końca. Sprawdź identyfikatory, ceny, statusy, kategorie oraz wartości logiczne. W schemacie WooCommerce wartości logiczne mogą być zapisywane między innymi jako 1 i 0. Kategorie i ich hierarchię trzeba zapisać zgodnie z formatem obsługiwanym przez WooCommerce, z użyciem przecinków oraz znaków > tam, gdzie potrzebna jest struktura nadrzędna i podrzędna.
- Kodowanie: UTF-8.
- Nagłówki: rozpoznawane nazwy kolumn WooCommerce.
- Identyfikatory: poprawne ID albo SKU.
- Dane: ceny, statusy, kategorie i wartości logiczne w prawidłowym formacie.
- Bezpieczeństwo: kopia zapasowa przed importem oraz mała próbka do testu.
Mapowanie kolumn to nie formalność
Po wskazaniu pliku WooCommerce może automatycznie rozpoznać część kolumn i przypisać je do pól produktu. Nie klikaj jednak odruchowo dalej. Przejrzyj ekran mapowania i sprawdź, czy każda kolumna trafiła tam, gdzie powinna. Jeśli coś zostało rozpoznane źle, popraw przypisanie. Kolumny, których nie chcesz importować, możesz wyłączyć.
To właśnie tutaj warto wyłapać literówki w nagłówkach, niepasujące pola albo dane, które przypadkiem mogłyby nadpisać istniejące informacje. Samo wgranie arkusza nie kończy pracy. Import zaczyna się dopiero wtedy, gdy wiesz, co importer zrobi z każdą istotną kolumną.
Jak masowo zmienić ceny, kategorie i statusy
Aktualizacja po SKU lub ID
Masowa aktualizacja produktów działa na podstawie dopasowania produktu po ID lub SKU. Przygotuj więc CSV zawierający identyfikatory produktów oraz kolumny z danymi, które chcesz zmienić. Przy cenach mogą to być pola Regular price i Sale price, a przy kategoriach pole Categories.
W importerze zaznacz opcję aktualizacji istniejących produktów. Następnie sprawdź mapowanie i upewnij się, po czym rekordy będą dopasowywane. WooCommerce aktualizuje pasujące produkty, a rekordy bez dopasowania po ID lub SKU pomija. To ważna informacja: brak zmiany nie zawsze oznacza awarię. Czasem po prostu identyfikator nie pasuje do produktu w sklepie.
Przed dużą operacją przygotuj małą próbkę. Możesz też najpierw wyeksportować wybraną grupę produktów, zmienić tylko konkretne pola i porównać efekt. Błędne SKU albo ID może oznaczać pominięcie rekordu lub aktualizację nie tego produktu, który był na liście.
Status produktu w kolumnie Published
Za status produktu odpowiada kolumna Published. Dokumentacja WooCommerce opisuje między innymi wartości: 1 dla produktu opublikowanego, 0 dla prywatnego, -1 dla wersji roboczej oraz 2 dla produktu oczekującego na sprawdzenie. Wartości trzeba zapisać dokładnie zgodnie ze schematem, zamiast wpisywać własne słowa typu „tak”, „nie” albo „ukryty”.
Podczas importu nie odświeżaj strony i nie opuszczaj ekranu importera. Po zakończeniu sprawdź log oraz kilka produktów bezpośrednio w sklepie. Dzięki temu zobaczysz, czy zmiany cen, kategorii i statusów faktycznie trafiły tam, gdzie planowałeś.
Warianty bez chaosu: produkt nadrzędny, Parent i SKU
Najpierw rodzic, potem warianty
Produkty wariantowe wymagają większej uwagi niż zwykła lista prostych produktów. Każdy wariant powinien mieć własne SKU, a kolumna Parent musi wskazywać właściwy produkt nadrzędny. Nazwy i wartości atrybutów powinny odpowiadać atrybutom skonfigurowanym przy produkcie nadrzędnym.
Jeśli rodzic ma atrybut „Rozmiar”, a w CSV pojawiają się inne nazwy albo wartości zapisane w odmienny sposób, warianty mogą nie połączyć się tak, jak oczekujesz. Dlatego przy większej migracji produktów WooCommerce najpierw sprawdź produkt nadrzędny, potem powiązania Parent, a dopiero później przechodź przez warianty.
Nie zaczynaj od pełnego katalogu. Wybierz kilka przykładów i sprawdź, czy warianty pokazują właściwe atrybuty, ceny, stany magazynowe oraz dostępne kombinacje. Dopiero po kontroli próbki warto importować kolejne partie. Kopia zapasowa albo środowisko testowe też nie są przesadą, szczególnie gdy dane mają zmienić działający sklep.
Zdjęcia w CSV — co może się wysypać?
Adres URL to jeszcze nie gwarancja zdjęcia
Zdjęcia używane w imporcie powinny być wcześniej dostępne w bibliotece mediów albo pod bezpośrednim adresem online. WooCommerce może pobierać je z dostępnych adresów URL, ale linki ukryte za skryptami przekierowującymi mogą nie zadziałać. Sam fakt, że adres otwiera się w przeglądarce, nie oznacza jeszcze, że importer pobierze plik poprawnie.
Po imporcie otwórz kilka produktów i sprawdź zdjęcie główne oraz galerię. Nie opieraj się wyłącznie na komunikacie o zakończeniu operacji. Wbudowany importer nie obsługuje masowej edycji tekstu alternatywnego zdjęć, więc tego elementu nie należy traktować jako automatycznie załatwionego.
Korzystaj wyłącznie ze zdjęć, do których sklep ma prawo i które są bezpośrednio dostępne. Działający URL nie jest potwierdzeniem praw do wykorzystania grafiki.
Duży katalog? Importuj partiami, nie na hurra
Proces krok po kroku
Duży import lepiej potraktować jak operację wymagającą przygotowania, a nie jak wrzucenie arkusza do automatu. Bezpieczna kolejność wygląda tak:
- Wykonaj kopię zapasową sklepu.
- Przygotuj eksport albo uporządkowany plik CSV.
- Sprawdź SKU, ID, ceny, kategorie, statusy, warianty i zdjęcia.
- Przetestuj małą próbkę, najlepiej na kopii testowej albo stagingu, jeśli jest dostępny.
- Przejrzyj mapowanie kolumn.
- Uruchom import małej partii.
- Sprawdź wynik i dopiero potem przejdź do następnej partii.
Duże pliki warto dzielić na mniejsze części. Nie ma jednej uniwersalnej granicy liczby produktów, od której trzeba to zrobić. Przebieg importu zależy między innymi od pamięci serwera, limitów przesyłania i czasu przetwarzania. Podczas pracy nie odświeżaj strony ani nie opuszczaj ekranu importera.
Checklista po imporcie
Po każdej partii sprawdź log importu i zwróć uwagę na błędne albo pominięte rekordy. Potem otwórz produkty bezpośrednio na stronie. Nie wystarczy rzut oka na kilka nazw w panelu.
- Produkty proste i wariantowe.
- SKU oraz nazwy produktów.
- Ceny regularne i promocyjne.
- Kategorie oraz status publikacji.
- Atrybuty, warianty i stany magazynowe.
- Zdjęcie główne oraz galeria.
- Widok produktu po stronie sklepu.
Jeśli coś się nie zgadza, zatrzymaj kolejną partię i wyjaśnij problem. Przechodzenie dalej z błędnym mapowaniem zwykle nie pomaga. Kontrola po imporcie jest praktyczną syntezą najważniejszych punktów awarii, a nie gwarancją, że każda operacja przebiegnie identycznie w każdym sklepie.
Kiedy lepiej nie robić tego samemu
Samodzielny import ma sens, gdy dane są uporządkowane, identyfikatory pewne, a zakres zmian jasny. Warto jednak rozważyć pomoc, gdy katalog ma dużo wariantów, powiązania Parent są niepewne albo SKU i ID nie trzymają się kupy.
Ostrożność jest szczególnie ważna przy danych z hurtowni w innym formacie, niestandardowych polach oraz zmianach wykonywanych bezpośrednio na działającym sklepie. Zasady wbudowanego importera nie muszą automatycznie pasować do płatnych rozszerzeń, integracji ani własnych pól. W takim przypadku najpierw trzeba sprawdzić dokumentację konkretnego rozwiązania.
Podsumowując: dobry import produktów WooCommerce CSV to nie samo wgranie pliku. Najpierw uporządkuj dane, zapisz CSV w UTF-8, sprawdź SKU lub ID, przejrzyj mapowanie i wykonaj kopię zapasową. Zacznij od próbki, importuj partiami, a po każdej partii skontroluj ceny, kategorie, statusy, warianty, stany i zdjęcia. Jeśli CSV zaczyna wyglądać jak sudoku bez rozwiązania, Napisz do Szwagra i opowiedz, czego potrzebujesz — strony, grafiki, filmu albo tekstów.
