Dlaczego produkty po imporcie mogą zniknąć z katalogu WooCommerce?
„Zniknięte” produkty po imporcie nie zawsze oznaczają awarię WooCommerce. Czasem rekord istnieje w panelu, ale jest ukryty w katalogu. Innym razem import zakończył się bez błędu, lecz dane trafiły do niewłaściwych pól, warianty nie zostały utworzone albo ustawienia widoczności odcinają produkt od sklepu i wyszukiwarki. Dlatego najpierw trzeba ustalić, co dokładnie zniknęło: cały produkt, tylko warianty, czy wyłącznie jego widoczność na froncie.
To ważne rozróżnienie, bo każda z tych sytuacji ma inną przyczynę. Produkt prosty, produkt zmienny, atrybuty, warianty, status publikacji i widoczność katalogu to osobne elementy układanki. Jeśli potraktujesz je jak jeden problem, łatwo wejść w zgadywanie zamiast w diagnostykę.
Najczęstszy błąd w diagnozie
Wiele osób zaczyna od ponownego importu, choć problem leży w danych źródłowych albo w ustawieniach produktu. W praktyce najpierw warto sprawdzić, czy rekord został utworzony, czy tylko nie jest wyświetlany.
Dobry punkt startowy jest prosty: sprawdź, czy produkt pojawia się w panelu WooCommerce, czy ma właściwy status, czy jest przypisany do kategorii i czy jego widoczność nie została ograniczona. Dopiero potem przechodź do CSV, mapowania pól i wariantów.
Jak sprawdzić CSV, zanim winą obarczysz WooCommerce?
Zanim zaczniesz szukać błędu w WooCommerce, sprawdź sam plik CSV. W praktyce to właśnie źle zapisany separator, kodowanie znaków, cudzysłowy albo przesunięte kolumny najczęściej sprawiają, że import wygląda poprawnie, a produkty trafiają nie tam, gdzie powinny.
CSV nie jest „jednym prostym plikiem”. W zależności od narzędzia i lokalizacji systemu ten sam eksport może wymagać innego separatora, innego kodowania i innego sposobu zapisu pól pustych. Jeśli plik został przygotowany w Excelu lub innym arkuszu kalkulacyjnym, bardzo łatwo o sytuację, w której przecinki rozbijają wartości tekstowe albo polskie znaki psują strukturę importu.
- Sprawdź, czy separator odpowiada ustawieniom importera, na przykład średnik zamiast przecinka.
- Zweryfikuj kodowanie pliku, najlepiej UTF-8 bez dziwnych konwersji po drodze.
- Upewnij się, że pierwszy wiersz zawiera czytelne nagłówki kolumn.
- Sprawdź, czy cudzysłowy nie zamykają przypadkiem kilku kolumn w jedną wartość.
- Porównaj liczbę kolumn w kilku losowych wierszach, żeby wyłapać przesunięcia danych.
- Upewnij się, że SKU lub identyfikator produktu nie są puste, jeśli importer ich wymaga.
Typowy błąd z lokalizacją
W arkuszu zapisanym po polsku kolumna z opisem może zawierać przecinki, a plik został wyeksportowany jako CSV z separatorem przecinka. Importer odczyta wtedy część opisu jako osobne kolumny. Efekt bywa mylący: produkt powstaje, ale nazwa, cena lub SKU trafiają do niewłaściwych pól.
Nie ufaj samemu podglądowi
To, że plik „otwiera się poprawnie” w arkuszu, nie znaczy jeszcze, że WooCommerce odczyta go tak samo. Najpewniejszy test to import kilku rekordów próbnych i sprawdzenie, czy każda kolumna trafiła tam, gdzie powinna.
Czy mapowanie pól podczas importu nie podmieniło danych w złe miejsca?
Nawet poprawny plik CSV nie gwarantuje poprawnego importu, jeśli kolumny zostały źle przypisane do pól WooCommerce. W takiej sytuacji produkt może pojawić się w panelu, ale z pustym tytułem, nieprawidłowym SKU, błędną kategorią albo bez danych, które decydują o wyszukiwaniu i widoczności oferty.
Pola krytyczne dla widoczności
Największe znaczenie mają zwykle nazwa produktu, SKU, kategoria, cena regularna, stan magazynowy i obrazek wyróżniający. Jeśli któreś z nich trafi do niewłaściwej kolumny, produkt może wyglądać na zaimportowany, ale trudno go odnaleźć w katalogu lub filtrowaniu.
Typowy scenariusz błędu
Zdarza się, że nazwa produktu zostaje wpisana do opisu, a SKU do pola niestandardowego. Import przechodzi bez wyraźnego komunikatu, ale produkt staje się praktycznie niewidoczny dla administratora i dla użytkownika, bo wyszukiwanie nie ma czego złapać.
- Sprawdź, czy nazwa produktu trafiła do właściwego pola.
- Porównaj SKU w CSV z polem identyfikującym produkt w WooCommerce.
- Zweryfikuj przypisanie kategorii i stan magazynowy.
- Upewnij się, że cena regularna nie została wklejona do opisu lub atrybutu.
- Sprawdź, czy obrazek wyróżniający nie został przypisany do złej kolumny.
Dlaczego to bywa trudne do zauważenia
Importery często nie zgłaszają błędu, jeśli dane są formalnie poprawne, ale trafiły do niewłaściwych pól. Dlatego po każdej zmianie mapowania warto wykonać mały import testowy i porównać wynik z plikiem źródłowym zamiast od razu uruchamiać pełny import.
Jak rozpoznać, że problem leży w atrybutach i wariantach produktu zmiennego?
W przypadku produktu zmiennego „zniknięcie” po imporcie bardzo często nie oznacza utraty produktu nadrzędnego, tylko brak wariantów albo niepoprawne przypisanie atrybutów. W panelu możesz widzieć poprawny rekord, a na froncie klient nie zobaczy rozmiarów, kolorów lub całej sekcji wyboru wariantu.
Najpierw oddziel dwa poziomy: produkt zmienny i jego warianty. Produkt nadrzędny może być zaimportowany prawidłowo, ale jeśli atrybuty nie zostały oznaczone jako używane dla wariantów, WooCommerce nie zbuduje kombinacji wartości. To częsty powód sytuacji, w której nazwa produktu jest widoczna, a selektory rozmiaru czy koloru znikają.
Typowy scenariusz
W CSV znajdują się atrybuty, ale po imporcie są zapisane jako zwykłe cechy produktu, a nie jako baza dla wariantów. Efekt: produkt istnieje, lecz nie ma rozwijanej listy rozmiarów ani kolorów, bo system nie dostał kompletnej informacji o kombinacjach.
- Czy produkt został oznaczony jako zmienny.
- Czy atrybuty są przypisane do tego konkretnego produktu.
- Czy atrybuty mają zaznaczone użycie dla wariantów.
- Czy w danych importu istnieją pełne kombinacje wartości wariantów.
- Czy domyślne warianty nie wskazują na pustą lub nieistniejącą kombinację.
Na czym najczęściej polega błąd
Nie każdy atrybut automatycznie tworzy wariant. Samo dodanie wartości, takich jak „S”, „M”, „L” albo „czerwony”, nie wystarczy, jeśli importer nie zbudował rekordów wariantów albo atrybuty nie zostały powiązane z produktem zmiennym w oczekiwany przez WooCommerce sposób.
Kiedy warto zajrzeć do dokumentacji
Jeśli produkt nadrzędny wygląda poprawnie, ale warianty nadal się nie pojawiają, sprawdź dokumentację WooCommerce dotyczącą produktów zmiennych, atrybutów i sposobu importu wariantów. To zwykle najszybciej pokazuje, czy problem leży w strukturze danych, czy w samym mapowaniu pól.
Jakie ustawienia widoczności i publikacji blokują wyświetlanie produktu?
Produkt może być poprawnie zaimportowany i nadal nie pojawiać się w sklepie, jeśli WooCommerce ukrywa go przez status publikacji, ustawienia widoczności albo brak przypisania do właściwego katalogu. W takim przypadku problem nie leży w samym imporcie, tylko w tym, jak system ma pokazywać rekord na froncie.
Najpierw sprawdź podstawy w edycji produktu: czy ma status opublikowany, czy nie jest oznaczony jako prywatny, czy jest przypisany do kategorii i czy jego widoczność nie została ograniczona do samego panelu. To szybki audyt, który często od razu pokazuje, dlaczego towar jest dostępny w bazie, ale niewidoczny dla klienta.
Przykład z praktyki
Produkt bywa opublikowany, ale ustawiony jako niewidoczny w katalogu i wyszukiwarce. Dla administratora wygląda jak istniejący rekord, jednak na stronie sklepu nie ma go ani w archiwach, ani w wynikach wyszukiwania. Taki przypadek łatwo pomylić z błędem CSV, choć przyczyna jest wyłącznie po stronie ustawień widoczności.
Na co uważać
Na efekt widoczności wpływają też motyw i wtyczki katalogowe. Jeśli sklep korzysta z dodatkowych filtrów, reguł ukrywania produktów lub własnych modyfikacji listingu, ustawienie w WooCommerce może nie wystarczyć, aby produkt faktycznie pojawił się na stronie.
- Sprawdź status produktu: opublikowany, prywatny lub szkic.
- Upewnij się, że widoczność katalogu obejmuje sklep i wyszukiwarkę.
- Zweryfikuj przypisanie do kategorii.
- Sprawdź, czy filtr stanów magazynowych nie ukrywa produktu.
- Porównaj ustawienia produktu z zasadami motywu i wtyczek katalogowych.
Co sprawdzić w bazie, logach i na poziomie integracji, gdy import wygląda poprawnie?
Jeśli CSV wygląda dobrze, mapowanie pól się zgadza, a mimo to produkty nadal „znikają”, trzeba zejść poziom niżej: do logów, bazy i integracji. Na tym etapie najczęściej wychodzi, że import nie usuwa rekordów, tylko są one później nadpisywane, ukrywane albo filtrowane przez dodatkową warstwę automatyzacji.
Gdzie szukać śladu problemu
- Sprawdź logi importu i komunikaty WooCommerce — szukaj ostrzeżeń o duplikatach SKU, błędach API lub niezgodnych danych.
- Porównaj rekord w bazie z tym, co widać w panelu i na froncie: produkt może istnieć, ale być ukrywany przez stan magazynowy, widoczność lub reguły wtyczki.
- Zweryfikuj, czy nie działa synchronizacja zewnętrzna, cron albo integracja ERP, która po imporcie nadpisuje status, kategorię lub dostępność.
- Wyłącz na próbę wtyczki wpływające na cache, stany magazynowe i listing produktów, jeśli problem pojawia się tylko na froncie.
Przykład konfliktu integracji
Zdarza się, że import przebiega bez błędów, ale osobna wtyczka do synchronizacji stanów magazynowych ukrywa produkty z zerowym stanem. W panelu rekord wygląda poprawnie, natomiast na stronie sklepu znika, bo dodatkowy mechanizm filtruje ofertę po własnych regułach.
Uwaga na pozorne „braki”
Cache i automatyzacje potrafią mylić objawy. To, co wygląda jak zniknięcie produktu po imporcie, bywa tylko opóźnionym odświeżeniem widoku albo skutkiem kolejnego procesu, który uruchamia się po zapisie danych.
Co warto sprawdzić w pierwszej kolejności
Najbardziej praktyczna ścieżka to: logi WooCommerce, logi serwera, historia synchronizacji wtyczek oraz porównanie SKU między plikiem CSV a bazą. Jeśli masz staging, testuj tam najpierw pełny łańcuch: import, zapis, odświeżenie cache i widoczność na sklepie.
Jak zbudować bezpieczną procedurę naprawy i ponownego importu?
Gdy masz już zawężone źródło problemu, nie wracaj od razu do pełnego importu. Bezpieczna naprawa w WooCommerce polega na tym, by najpierw zabezpieczyć dane, potem odtworzyć błąd na małej próbce i dopiero na końcu uruchomić ponowne ładowanie całego katalogu. Dzięki temu nie naprawiasz w ciemno i nie ryzykujesz kolejnego masowego przesunięcia produktów, wariantów albo stanów magazynowych.
- Zrób kopię zapasową bazy i plików sklepu, zanim cokolwiek zmienisz.
- Przygotuj mały eksport testowy albo ograniczony plik CSV z kilkoma rekordami.
- Sprawdź import na stagingu, a nie od razu na produkcji.
- Po imporcie porównaj produkt źródłowy z rekordem w WooCommerce: nazwę, SKU, kategorię, atrybuty, warianty i widoczność.
- Wyczyść lub odśwież cache, jeśli sklep korzysta z pamięci podręcznej lub warstw synchronizacji.
- Dopiero po potwierdzeniu poprawnego działania uruchom pełny import lub korektę całej paczki.
Co daje taki proces
Taka procedura odcina najczęstszy błąd diagnostyczny: wielokrotne uruchamianie tego samego importu bez sprawdzenia, czy problem nie leży w mapowaniu, widoczności albo późniejszej synchronizacji. Test na kilku rekordach pozwala szybciej ocenić, czy naprawa naprawdę działa, czy tylko ukrywa objawy.
Nie zakładaj, że każdy sklep zareaguje tak samo
Motyw, dodatkowe wtyczki, integracje ERP i reguły magazynowe mogą zmieniać to, co dzieje się po imporcie. W jednym sklepie wystarczy poprawić CSV, w innym po imporcie trzeba jeszcze przejść przez cache, synchronizację i ustawienia listingu. Dlatego checklistę warto traktować jako ramę, a nie gotową receptę bez wyjątków.
- aktualną kopię zapasową
- plik CSV po eksporcie testowym
- dostęp do stagingu
- listę pól krytycznych: nazwa, SKU, kategoria, cena, stan, widoczność
- dostęp do logów WooCommerce i integracji
- krótką checklistę QA po imporcie
FAQ
Czy produkt może być zaimportowany poprawnie i mimo to nie być widoczny w sklepie?
Tak. Produkt może istnieć w bazie, ale być ukryty przez ustawienia widoczności, status publikacji, brak przypisanej kategorii albo błędne mapowanie pól w imporcie.
Od czego zacząć diagnozę, gdy po imporcie nie widać produktów?
Najpierw sprawdź, czy rekordy istnieją w panelu, potem zweryfikuj CSV, mapowanie pól, status produktu i ustawienia widoczności. Dopiero później przechodź do logów i konfliktów wtyczek.
Czy błędny separator CSV naprawdę może zepsuć import?
Tak. Nieprawidłowy separator, kodowanie znaków lub cudzysłowy mogą sprawić, że kolumny zostaną odczytane błędnie, a dane trafią do niewłaściwych pól.
Dlaczego produkt zmienny ma nazwę, ale nie ma wariantów?
Najczęściej atrybuty nie zostały poprawnie przypisane do wariantów, dane wariantów nie zostały zaimportowane albo rekord produktu nadrzędnego nie zawiera kompletu kombinacji.
Czy trzeba sprawdzać logi po każdym nieudanym imporcie?
W większych sklepach tak, bo logi pomagają odróżnić błąd danych od konfliktu wtyczek, cache lub synchronizacji stanów magazynowych.
Sprawdź plik CSV, mapowanie pól i ustawienia wariantów zanim uruchomisz kolejny import — to najkrótsza droga do znalezienia przyczyny znikających produktów.
Rafał Jóśko
Lokalizacja: Lublin
Pomagam firmom przejść przez chaos świata online. Z ponad 15-letnim doświadczeniem i ponad 360 zrealizowanymi projektami oferuję kompleksowe prowadzenie działań digital: od strategii, przez hosting, SEO i automatyzacje, aż po skuteczne kampanie marketingowe. Tworzę spójne procesy, koordynuję zespoły i eliminuję niepotrzebne koszty – Ty skupiasz się na biznesie, ja dbam o resztę.
Wspieram zarówno startupy, jak i rozwinięte firmy B2B/B2C. Działam z Lublina, ale efekty mojej pracy sięgają daleko poza granice Polski.