WooCommerce CSV: eksport i aktualizacja pól własnych produktów

WooCommerce CSV pozwala wyeksportować metadane produktu, a następnie wczytać zmienione wartości do katalogu, co opisuje dokumentacja importera i eksportera WooCommerce. Przy eksporcie zaznacz opcję Yes, export all custom meta, a w pliku znajdź kolumnę zaczynającą się od meta:. Do aktualizacji zachowaj jej nagłówek, dodaj identyfikator produktu, włącz Update existing products i sprawdź mapowanie kolumn przed uruchomieniem importu. WooCommerce dopasowuje aktualizowane produkty po ID lub SKU; od wersji 11.2 może też użyć GTIN, UPC, EAN lub ISBN, gdy ID i SKU są puste.

W skrócie

Eksport metadanych wymaga zaznaczenia Yes, export all custom meta.
Własne pole importujesz z nagłówkiem meta:nazwa_klucza, na przykład meta:product_depth.
Do aktualizacji użyj stabilnego ID lub SKU i zaimportuj tylko wiersze, które chcesz zmienić.
Przed masową aktualizacją sprawdź małą próbkę i kopię katalogu.

Czym są pola własne i kolumny meta w WooCommerce CSV?

Pola własne produktu to dodatkowe dane zapisane jako metadane, poza standardowymi polami, takimi jak nazwa, cena czy stan magazynowy. WooCommerce może udostępnić w eksporcie metadane zapisane przez siebie lub inne wtyczki. Ich kolumny mają prefiks meta:; na przykład klucz product_depth pojawia się jako meta:product_depth. Dokumentacja WooCommerce opisuje ten format i mapowanie importu.

Nie zakładaj, że etykieta widoczna w panelu jest nazwą klucza metadanych. Sprawdź nagłówek wygenerowany w eksporcie i użyj go dokładnie. Jeśli kolumna nie mapuje się automatycznie, na ekranie Column mapping wybierz dla niej Import as meta. Nieznane kolumny są domyślnie pomijane.

Na dzień sprawdzenia, 23 października 2026 r., stabilną wersją WooCommerce na liście wydań jest 11.2.1, a najnowszym wydaniem WordPressa w serii 7.1 jest 7.1.3. Zmiana dopasowywania po Global Unique ID dotyczy WooCommerce 11.2 i nowszych. Lista wydań WooCommerce i wykaz wersji WordPressa podają te numery. Widoczne nazwy opcji w panelu mogą zależeć od języka instalacji.

Eksport pól własnych do CSV

Wbudowane narzędzie eksportu znajdziesz w Products > All Products. Możesz wybrać zakres produktów i typów, a także zaznaczyć wszystkie dostępne kolumny lub wskazać wybrane. Przy aktualizacji pojedynczego fragmentu katalogu zawęź eksport do potrzebnych produktów, by łatwiej sprawdzić plik.

Otwórz Products > All Products i wybierz Export.
Wybierz kolumny, typy produktów i kategorie. Jeśli nie chcesz filtrować katalogu, zostaw ustawienia domyślne.
Zaznacz Yes, export all custom meta, aby dołączyć metadane produktu.
Wybierz Generate CSV i otwórz pobrany plik w arkuszu lub edytorze CSV.
Odszukaj właściwy nagłówek meta:... i sprawdź, czy wartości odpowiadają produktom, które chcesz zmienić.

Przy aktualizacji kilku wskazanych produktów możesz zaznaczyć je na liście i wybrać Export X selected. To ogranicza plik do zaznaczonego zestawu. Dokumentacja eksportu WooCommerce opisuje zarówno eksport całego lub filtrowanego katalogu, jak i eksport zaznaczonych produktów.

Element CSV	Przykład	Do czego służy
`ID`	`100`	Identyfikuje istniejący produkt do aktualizacji.
`SKU`	`kubek-01`	Identyfikuje produkt po kodzie SKU.
Nagłówek meta	`meta:product_depth`	Wskazuje klucz metadanych, który ma zostać zaimportowany.
Wartość pola	`12`	Nowa wartość, którą chcesz przypisać produktowi.

Przygotowanie pliku do masowej aktualizacji katalogu

Najbezpieczniej zacząć od eksportu z WooCommerce, zachować nagłówki kolumn i zmienić tylko potrzebne wartości. Przykład poniżej pokazuje dwa produkty aktualizowane po SKU. Klucz product_depth to przykład z dokumentacji WooCommerce, a wartość 12 jest przykładową daną.

SKU,Name,meta:product_depth
kubek-01,Kubek ceramiczny,12
kubek-02,Kubek z uchem,14

Wiersze w pliku muszą zawierać identyfikator istniejącego produktu, a nagłówek metadanych powinien zachować dokładny klucz z eksportu. Nazwa produktu w przykładzie ułatwia kontrolę wzrokową, ale nie zastępuje SKU ani ID jako identyfikatora aktualizacji. Wartość pola wpisz w formacie zgodnym z tym, jak dane pole jest używane przez sklep lub wtyczkę, która je dodała.

Przed importem sprawdź plik:

Zapisz go jako CSV w kodowaniu UTF-8. Edytory arkuszy mogą zmienić format lub kodowanie, więc otwórz zapisany plik ponownie i sprawdź znaki oraz nagłówki.
Usuń wiersze produktów, których nie chcesz aktualizować.
Sprawdź, czy nie zmieniły się zera wiodące w identyfikatorach lub wartościach.
Jeśli wartość zawiera przecinek, ujmij ją w cudzysłów zgodnie z formatem CSV.
Nie dodawaj przypadkowych kolumn. WooCommerce domyślnie pomija nierozpoznane nagłówki.

WooCommerce zaleca kodowanie UTF-8, a przy imporcie wartości logicznych użycie 1 dla prawdy i 0 dla fałszu. Wytyczne formatowania CSV obejmują też sposób zapisu wartości z przecinkami. Gdy metadane mają specyficzny format wymagany przez wtyczkę, sprawdź jej dokumentację, zamiast zakładać, że zwykły tekst zostanie przetworzony tak samo.

Import z aktualizacją istniejących produktów

Opcja Update existing products pozwala importerowi zaktualizować dopasowane produkty. W WooCommerce 11.2 i nowszym, gdy ID i SKU są puste, dopasowanie może odbyć się po przypisanym polu GTIN, UPC, EAN, or ISBN. Wartość ID lub SKU ma pierwszeństwo, więc błędne, niepasujące ID nie spowoduje automatycznego przejścia do dopasowania po GTIN. Zmianę wprowadzoną w WooCommerce 11.2 opisują notatki wydania.

Przejdź do Products > All Products i wybierz Import.
Wybierz plik CSV.
Zaznacz Update existing products.
Kliknij Continue. Na ekranie Column mapping sprawdź, czy ID albo SKU mapuje się na właściwe pole. Dla kolumny metadanych, która nie została rozpoznana automatycznie, wybierz Import as meta.
Ustaw Do not import dla każdej kolumny, której nie chcesz wczytać.
Wybierz Run the importer i poczekaj na zakończenie. Nie odświeżaj strony podczas importu.
Sprawdź raport importu, a potem otwórz kilka zmienionych produktów i potwierdź wartości pola.

Nie importuj pełnego katalogu, jeśli zmieniasz jedno pole w kilku produktach. Nieaktualne wartości w innych kolumnach mogą nadpisać dane, jeśli zostaną zmapowane. Przy dużych plikach WooCommerce zaleca kopię sklepu, próbę na środowisku testowym i podział danych na mniejsze partie. Wytyczne dla dużych importów i raportów błędów opisują te kroki oraz typowe powody pominięcia wierszy.

Częste błędy przy eksporcie i imporcie meta

Objaw	Co sprawdzić
Kolumny pola nie ma w eksporcie	Czy zaznaczono Yes, export all custom meta i czy pole jest zapisane jako metadane produktu.
Wartość się nie zmieniła	Czy nagłówek zawiera właściwy klucz po `meta:`, a kolumna mapuje się jako Import as meta.
Produkt został pominięty	Czy ID lub SKU istnieje w sklepie i czy zaznaczono Update existing products.
Zmieniło się więcej danych niż planowano	Czy pozostałe kolumny są ustawione na Do not import, jeśli mają być ignorowane.
Import zatrzymał się przy dużym pliku	Sprawdź raport, limit przesyłania i podziel CSV na mniejsze partie.

Ważne jest rozróżnienie między eksportem wszystkich metadanych a eksportem wybranych zwykłych kolumn. Jeśli eksportujesz wszystkie meta, przejrzyj nagłówki przed udostępnieniem pliku, ponieważ mogą pojawić się tam pola dodane przez inne wtyczki. To praktyczna kontrola zawartości pliku, szczególnie gdy CSV opuszcza zespół zarządzający sklepem.

FAQ

Czy mogę importować własne pola produktu przez standardowy importer WooCommerce?

Tak. Nagłówek kolumny powinien zaczynać się od meta: i zawierać klucz pola. Jeśli WooCommerce nie przypisze go automatycznie, na ekranie mapowania wybierz Import as meta. Opis formatu znajduje się w dokumentacji CSV WooCommerce.

Jak wyeksportować tylko wybrane produkty z metadanymi?

Na liście produktów zaznacz wybrane pozycje i użyj Export X selected. Następnie w opcjach eksportu zaznacz Yes, export all custom meta.

Czy import CSV nadpisuje dane produktu?

Przy zaznaczonej opcji Update existing products WooCommerce aktualizuje dopasowane wiersze i mapowane kolumny. Wybierz Do not import dla pól, których nie chcesz zmieniać, i sprawdź mapowanie przed uruchomieniem importu.

Co zrobić, gdy kolumna `meta:` nie aktualizuje pola?

Zweryfikuj klucz metadanych w nagłówku względem eksportu, a na ekranie mapowania przypisz kolumnę do Import as meta. Jeśli pole należy do wtyczki, sprawdź jej dokumentację, ponieważ może ona oczekiwać określonego formatu danych.

Co dalej

Przed aktualizacją większej partii sprawdź identyfikatory i zawartość arkusza.