Import produktów do Magento 2
W tym artykule opisaliśmy krok po kroku proces importu prodktów do sklepu opartego o Magento 2.
Import produktów w Magento 2 może wydawać się skomplikowany, zwłaszcza jeśli robisz to pierwszy raz. Ale spokojnie – w tym artykule pokażę Ci dokładnie, jak w prosty sposób przygotować plik CSV, zrozumieć strukturę danych i przeprowadzić skuteczny import, który oszczędzi Ci mnóstwo czasu.
Magento oferuje bardzo rozbudowany system zarządzania produktami, co z jednej strony daje ogromne możliwości, a z drugiej... łatwo się w tym pogubić. Dlatego zebrałem dla Ciebie praktyczne wskazówki, przykłady i listę najważniejszych kolumn, które pomogą Ci uniknąć typowych błędów i z sukcesem załadować nawet setki produktów.
Import produktów do Magento 2 – kompletny przewodnik
Import produktów do sklepu Magento 2 to funkcja, która pozwala efektywnie dodawać, edytować lub aktualizować dane produktowe w Twoim sklepie. Dzięki wykorzystaniu plików CSV lub Excela możesz masowo wprowadzać zmiany w katalogu produktów bez potrzeby ręcznego edytowania każdego wpisu.
To idealne rozwiązanie dla:
- sklepów z dużą ilością asortymentu,
- migracji danych z innych platform,
- cyklicznych aktualizacji stanów i cen.
Poniżej przedstawiam krok po kroku, jak przeprowadzić poprawny import produktów do Magento 2, unikając najczęstszych błędów.
1. Przygotowanie pliku CSV do importu
Twój plik musi zawierać kolumny odpowiadające polom danych produktów, takim jak:
Dane podstawowe
Kolumna | Opis |
---|---|
sku
|
Unikalny identyfikator produktu |
store_view_code
|
Kod widoku sklepu (np. default) |
attribute_set_code
|
Zestaw atrybutów, np. Default |
product_type
|
Typ produktu (simple, configurable, itd.) |
name
|
Nazwa produktu |
description
|
Pełny opis produktu |
short_description
|
Krótszy opis produktu |
url_key
|
Przyjazny link URL |
Ceny i dostępność
Kolumna | Opis |
---|---|
price
|
Cena standardowa |
special_price
|
Cena promocyjna |
special_price_from_date
|
Początek promocji |
special_price_to_date
|
Koniec promocji |
tax_class_name
|
Klasa podatkowa |
product_online
|
Aktywność produktu (1 = tak) |
visibility
|
Widoczność (1–4) |
Kategorie i SEO
Kolumna | Opis |
---|---|
categories
|
Ścieżki kategorii (np. Odzież/Damska) |
product_websites
|
Strony internetowe (websites) |
meta_title
|
Tytuł SEO |
meta_keywords
|
Słowa kluczowe SEO |
meta_description
|
Opis SEO |
Obrazy i etykiety
Kolumna | Opis |
---|---|
base_image
|
Główne zdjęcie produktu |
small_image
|
Miniatura dla listy |
thumbnail_image
|
Ikonka produktu |
swatch_image
|
Obrazek wariantu (np. kolor) |
additional_images
|
Inne zdjęcia produktu |
Produkty powiązane i powiązania sprzedażowe
Kolumna | Opis |
---|---|
related_skus
|
SKU produktów powiązanych (przy zakupie rekomendowane razem) |
related_position
|
Kolejność wyświetlania produktów powiązanych |
crosssell_skus
|
Produkty cross-sell (proponowane w koszyku) |
crosssell_position
|
Kolejność produktów cross-sell |
upsell_skus
|
Produkty upsell (droższe lub lepsze zamienniki) |
upsell_position
|
Kolejność produktów upsell |
Projektowanie i układ strony
Kolumna | Opis |
---|---|
custom_design
|
Wybór niestandardowego motywu |
custom_design_from
|
Data rozpoczęcia niestandardowego designu |
custom_design_to
|
Data zakończenia niestandardowego designu |
custom_layout_update
|
Kod XML zmieniający układ strony produktu |
page_layout
|
Układ strony (np. 1column, 2columns-left) |
Ceny MAP i MSRP
Kolumna | Opis |
---|---|
map_price
|
Minimalna cena reklamowa (MAP) |
msrp_price
|
Sugerowana cena detaliczna (MSRP) |
map_enabled
|
Czy MAP jest włączone (1 = tak) |
msrp_display_actual_price_type
|
Sposób prezentacji ceny rzeczywistej |
Inne istotne kolumny
Kolumna | Opis |
---|---|
gift_message_available
|
Możliwość dołączenia wiadomości do prezentu |
country_of_manufacture
|
Kraj produkcji |
additional_attributes
|
Atrybuty niestandardowe w formacie klucz=wartość |
created_at
|
Data utworzenia produktu |
updated_at
|
Data ostatniej aktualizacji |
Upewnij się, że plik CSV jest w kodowaniu UTF-8, a zdjęcia znajdują się w
katalogu pub/media/import
.
2. Wejście do panelu administracyjnego Magento
Zaloguj się do panelu administracyjnego Magento i przejdź do:
System > Import/Export > Import
3. Konfiguracja ustawień importu
Magento pozwala dostosować zachowanie importu:
- Entity Type (Rodzaj danych do importu): Products
- Import Behavior (Określenie zachowania importu): Add/Update, Replace, Delete
- Validation Strategy (Strategia walidacji importu): Stop on Error lub Skip Error Entries
- Allowed Errors Count (Liczba dozwolonych błędów): np. 10
Gdy chcemy importować także obrazy produktów musimy je wgrać do odpowiedniego katalogu na serwerze (np. przez FTP) i podać ścieżkę do tego katalogu w polu "Katalog plików obrazków"
4. Mapowanie pól danych
Jeśli kolumny w Twoim pliku CSV nie mają standardowych nazw Magento – użyj opcji mapowania.
5. Wgrywanie pliku CSV do systemu
Kliknij "Wybierz plik" i załaduj swój plik CSV. Upewnij się, że plik:
- nie zawiera pustych wierszy,
- ma poprawne nagłówki,
- nie zawiera błędnych znaków.
6. Walidacja danych i testowanie importu
Zaleca się testować import na kilku produktach, zanim załadujesz całą bazę – dzięki temu unikniesz problemów z danymi na produkcji.

7. Rozpoczęcie importu produktów
Jeśli wszystko wygląda dobrze – kliknij "Import" i rozpocznij proces.

8. Weryfikacja efektów importu
Sprawdź raport importu oraz kilka produktów w katalogu, aby upewnić się, że wszystko działa poprawnie.
Najczęstsze błędy podczas importu produktów
- Zduplikowane SKU
- Brak wymaganych kolumn
- Błędne nazwy kategorii lub atrybutów
- Zdjęcia nie zostały wcześniej wgrane
Podsumowanie
Import produktów w Magento 2 to potężne narzędzie, które – przy odpowiednim przygotowaniu – może znacznie przyspieszyć pracę i ograniczyć błędy. Korzystając z tego poradnika krok po kroku, jesteś na dobrej drodze do opanowania całego procesu!