Czy wideo w galerii produktu WooCommerce działa z wariantami i CSV?

Wideo produktu WooCommerce można dodać do galerii obok zdjęć, jeśli korzystasz z WooCommerce 11.1 lub nowszego i włączysz funkcję eksperymentalną. Są jednak dwa ważne ograniczenia: w wersji 11.1 wideo nie trafia do galerii wariantu ani przez standardowy import CSV. Jeśli film ma być wspólny dla całego produktu, dodaj go ręcznie do galerii produktu nadrzędnego. Wideo przypisane do wybranego wariantu nie jest obsługiwane w galerii wariantu WooCommerce 11.1; do takiego działania potrzebne jest dodatkowe rozwiązanie.

W skrócie

• Galeria produktu: tak, obsługuje wideo z biblioteki mediów po włączeniu funkcji.
• Galeria wariantu: nie, dokumentacja WooCommerce 11.1 wyklucza wideo z galerii wariantów.
• Import CSV: nie, standardowy importer nie przenosi wideo galerii. Kolumna Images dotyczy obrazów.
• Przygotowanie katalogu: importuj dane i zdjęcia, a filmy dodaj ręcznie do galerii produktu; potem sprawdź widok na stronie.

Stan dokumentacji sprawdzony 20 października 2026 r.

Wideo produktu WooCommerce: co obsługuje wersja 11.1

Od WooCommerce 11.1 można umieszczać filmy w galerii produktu obok zdjęć. Funkcja jest eksperymentalna i domyślnie wyłączona. Filmy trzeba wcześniej dodać do biblioteki mediów WordPressa. Osadzone materiały z YouTube, Vimeo i innych serwisów nie są obsługiwane przez tę funkcję galerii.

Wideo nie zastępuje głównego zdjęcia produktu. Może pojawić się jako kolejny element galerii, a sklep wykorzystuje jego obraz wyróżniający jako miniaturę, jeśli taki obraz ustawisz. Według dokumentacji odtwarzanie w galerii jest automatyczne, wyciszone i zapętlone, bez widocznych przycisków odtwarzania. To argument za krótkim, zrozumiałym klipem.

Obszar	Obsługa w WooCommerce 11.1	Co to oznacza przy przygotowaniu katalogu
Galeria produktu	Tak, po włączeniu funkcji eksperymentalnej	Dodaj wideo z biblioteki mediów do galerii produktu
Główne zdjęcie produktu	Wideo nie może go zastąpić	Pozostaw zdjęcie jako obraz główny
Galeria wariantu	Wideo nie jest obsługiwane	Filmu nie przypiszesz natywnie do wariantu
Import i eksport CSV	Wideo nie jest uwzględniane	Importuj zdjęcia, a wideo dodaj osobno
YouTube lub Vimeo	Osadzenia zewnętrzne nie są obsługiwane w tej galerii	Potrzebny jest plik w bibliotece mediów albo inne rozwiązanie

Szczegóły, w tym obsługiwane widoki galerii i warunek zgodności motywu, opisuje dokumentacja galerii obrazów i wideo WooCommerce. Jeśli motyw zastępuje standardowe szablony galerii własnymi, filmy mogą nie wyświetlić się, dopóki motyw nie doda obsługi.

Jak włączyć wideo i dodać je do galerii

Instrukcja dotyczy WooCommerce 11.1 i WordPressa 7.1. Plik readme gałęzi WooCommerce 11.1 podaje minimalną wersję WordPressa 7.0 i testowanie do wersji 7.1. W WooCommerce 11.1 ustawienie znajduje się w funkcjach eksperymentalnych. Nazwy opcji poniżej są podane w języku interfejsu dokumentacji.

1. W panelu przejdź do WooCommerce > Settings > Advanced > Features i odszukaj Experimental features.
2. Zaznacz Product gallery videos i wybierz Save changes.
3. Otwórz produkt do edycji. W polu Product gallery wybierz Add media to product gallery.
4. W bibliotece mediów zaznacz wideo oraz ewentualne zdjęcia i wybierz Add to gallery.
5. Ułóż elementy galerii, a następnie wybierz Update lub Publish.
6. Otwórz stronę produktu i sprawdź kolejność oraz odtwarzanie filmu. Jeśli używasz własnego szablonu produktu, zweryfikuj, czy wyświetla on galerię WooCommerce obsługującą wideo.

Plik wideo musi być dostępny w bibliotece mediów, a limit jego rozmiaru zależy od ustawień hostingu. Dokumentacja wskazuje, że MP4 z H.264 odtwarza się w najszerszym zakresie przeglądarek. Aby ustawić miniaturę, przejdź do Media > Library, otwórz film, wybierz Edit more details, a następnie ustaw Featured image. Alternatywnie WooCommerce może pokazać podgląd wygenerowany z filmu.

Warianty i import CSV: gdzie jest granica

Warianty nadal możesz przygotować i importować jako osobne pozycje podrzędne produktu zmiennego. To jednak nie rozwiązuje kwestii filmu: dokumentacja wprost zaznacza, że w WooCommerce 11.1 wideo nie wchodzi do galerii wariantu ani do importu i eksportu CSV.

Standardowy importer ma kolumnę Images do obrazów. Dokumentacja opisuje wiersze wariantów i kolumnę Parent, która wiąże wariant z produktem nadrzędnym, ale nie opisuje pola CSV do przypisania wideo do galerii. Nie dodawaj więc własnej kolumny z adresem filmu i nie zakładaj, że WooCommerce ją zaimportuje: nieznane kolumny są domyślnie pomijane. Sprawdź schemat importu CSV WooCommerce, zanim przygotujesz plik dla dużej partii produktów.

Przykład: kurtka ma warianty „czarny, S” i „czarny, M”. CSV może zawierać informacje o wariantach i zdjęciach zgodnie ze schematem importera, ale natywna galeria wideo WooCommerce 11.1 nie przypisze do każdego rozmiaru osobnego filmu. Jeśli materiał prezentuje produkt niezależnie od rozmiaru, dodaj jeden klip do galerii produktu nadrzędnego. Jeżeli film ma zależeć od wybranego wariantu, trzeba sprawdzić wtyczkę lub rozwiązanie programistyczne, które jawnie obsługuje galerie wideo wariantów i ich import.

Zadanie	Standardowe narzędzie WooCommerce	Zalecany sposób pracy
Utworzenie wariantów	Importer CSV rozpoznaje warianty i relację z produktem nadrzędnym	Przygotuj i sprawdź dane wariantów w CSV
Import zdjęć	Kolumna Images w schemacie CSV	Wczytaj plik i sprawdź obrazy na stronie produktu
Dodanie filmu do galerii produktu	Edytor produktu, po włączeniu funkcji	Dodaj plik z biblioteki mediów ręcznie
Film zależny od wariantu	Brak natywnej obsługi w WooCommerce 11.1	Przed wdrożeniem sprawdź funkcje rozszerzenia na kopii sklepu

Plan przygotowania przed sezonem sprzedażowym

1. Ustal wersję WooCommerce. Funkcja galerii wideo jest opisana od wersji 11.1. Nie zakładaj, że działa w starszej wersji.
2. Podziel materiały według zastosowania. Film wspólny dla całego produktu dodaj do galerii produktu nadrzędnego. Filmy przypisane do konkretnych wariantów wymagają dodatkowej obsługi.
3. Przygotuj CSV bez kolumny udającej obsługę wideo. Wykorzystaj udokumentowane pola, takie jak Images, a przed importem sprawdź mapowanie kolumn.
4. Zaimportuj niewielką próbkę. Otwórz produkt nadrzędny i jego warianty, zweryfikuj zdjęcia oraz atrybuty.
5. Dodaj wideo i sprawdź sklep. Po dodaniu pliku sprawdź stronę na komputerze i telefonie oraz upewnij się, że motyw wyświetla galerię.
6. Powtórz kontrolę po aktualizacji lub zmianie motywu. Wyłączenie funkcji ukrywa filmy w edytorze i na stronie, ale nie usuwa plików ani ich pozycji w galerii.

Przy większym katalogu warto przetestować próbkę na środowisku testowym przed importem całości. Import wariantów może działać poprawnie, a jednocześnie nie przenosić filmów, bo są to osobne funkcje.

FAQ

Czy można dodać film z YouTube do galerii WooCommerce?

Natywna funkcja galerii opisana dla WooCommerce 11.1 korzysta z plików w bibliotece mediów. Osadzenia z YouTube, Vimeo i innych hostów nie są w niej obsługiwane. Możesz rozważyć osobną wtyczkę, jeśli potrzebujesz linków zewnętrznych.

Czy film może być głównym zdjęciem produktu?

Nie w natywnej galerii wideo WooCommerce 11.1. Wideo można dodać do galerii, ale obraz produktu pozostaje zdjęciem.

Czy importer CSV doda wideo do produktu lub wariantu?

Nie w standardowym importerze opisanym dla WooCommerce 11.1. Schemat zawiera pole Images dla obrazów, a dokumentacja galerii wyklucza wideo z importu i eksportu CSV.

Czy po wyłączeniu funkcji filmy znikają na stałe?

Nie. WooCommerce ukrywa filmy w edytorze produktu i na stronie, ale ich nie usuwa. Po ponownym włączeniu funkcji filmy wracają na dotychczasowe miejsca w galeriach.

Co dalej

Przed dodaniem materiałów sprawdź też jak przygotować kartę produktu: opisy, zdjęcia i dane. Jeśli klienci pytają o dostępne rozmiary lub kolory, zobacz, jak przygotować produkty WooCommerce dla asystenta AI. Sklepowy pomaga klientom wyszukiwać produkty w katalogu WooCommerce, sprawdzać ceny i dostępność oraz dobierać warianty. Poznaj Sklepowego.