# Import z plików CSV

Użyj CSV Import, aby szybko tworzyć lub aktualizować produkty (oraz stany magazynowe) w swoim sklepie Shopify za pomocą pliku arkusza kalkulacyjnego.

## ✅ Zanim zaczniesz (wymagania)

#### 📌 Przygotuj plik CSV

Upewnij się, że Twój plik CSV zawiera:

* **Nagłówki kolumn** w pierwszym wierszu (np. `Handle`, `Title`, `Vendor`)
* **Unikalny klucz**, którego możesz użyć do dopasowania rekordów (zalecany: **Handle**)
* Poprawny format (plik CSV)

#### 🔑 Zalecany klucz główny

* **Product Handle** (najlepszy w większości importów)
* W zależności od danych mogą być też inne klucze (np. Product ID, Variant SKU)

***

## 🛠️ Kroki przesyłania pliku&#x20;

### Otwórz CSV Uploads w aplikacji Tipo

<figure><img src="/media/2a19292f386ccfa6c516.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

1. W Shopify Admin otwórz **Apps → Tipo Sync**
2. Kliknij **CSV uploads**
3. Kliknij **Add csv file**

Zostaniesz przeniesiony do kreatora importu (postęp **1/3**).

***

### 📤 Krok 1/3 — Prześlij CSV&#x20;

<figure><img src="/media/e3560f7f8a801b3726ec.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **Wybierz źródło przesyłania**

Możesz przesłać plik CSV z:

* **CSV Import** (przesłanie pliku z komputera)
* Importu z linku internetowego (URL)
* Przesłania na serwer FTP
* Przesłania na serwer SFTP

#### **Wybierz opcje CSV**

**Separator**

* Przecinek (najczęściej)
* Średnik
* Inny

**Dane CSV**

* **Product** (pola produktu, np. tytuł, opis, dostawca…)
* **Inventory** (ilości magazynowe)

Następnie kliknij **Next Step**.

<figure><span class="missing-media" role="note">Ten zrzut ekranu jest niedostępny w oryginalnej dokumentacji.</span><figcaption></figcaption></figure>

***

### 🧩 Krok 2/3 — Mapowanie pól&#x20;

<figure><img src="/media/5beb2e9d9f197c6c8f0e.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

**A) Mapowanie klucza głównego**

To mówi aplikacji, jak dopasować wiersze w pliku CSV do produktów w Shopify.

* **Primary Key**: wybierz, według czego Twój sklep Shopify ma dopasowywać\
  Przykład: **Product Handle**
* **Column heading**: wybierz kolumnę w pliku CSV\
  Przykład: **Handle**

> Jeśli Twój klucz główny nie pasuje, aplikacja może utworzyć duplikaty lub nie zaktualizować właściwego produktu.

**B) Zmapuj kolumny CSV na pola Shopify**

Zobaczysz zakładki, takie jak:

* **Product**
* **Variant**
* **Image**
* **Metafield**
* **Inventory**

Dla każdego wiersza:

* **Import to Shopify** = pole Shopify (np. Title)
* **Column heading** = kolumna CSV (np. Title)

Aby zaimportować więcej pól, kliknij **➕ Add mapping**.

Następnie kliknij **Next Step**.

***

### ⚙️ Krok 3/3 — Ustawienia importu&#x20;

<figure><img src="/media/0982d902faf55aaf2e59.webp" alt="" loading="lazy" decoding="async"><figcaption></figcaption></figure>

#### **Krok 3.1. Dopasowanie i importy (jak aktualizować Shopify)**

Wybierz jedną opcję:

✅ **Create new items**

* Tylko tworzy nowe produkty (bez aktualizowania istniejących)

✅ **Only update current items that have the same primary key**

* Aktualizuje tylko istniejące produkty
* NIE tworzy nowych

✅ **Create new items if not exist and update current items that have the same primary key** *(częsty wybór)*

* Tworzy brakujące produkty
* Aktualizuje istniejące produkty, które pasują (wg Handle/SKU itd.)

***

#### **Krok 3.2. Zakres importu (ile zaimportować)**

* **Import All**: importuje wszystko z pliku
* **Specify import**: importuje tylko wybrany zakres wierszy (przydatne do testów)

***

#### **Krok 3.3. Filtrowanie danych (opcjonalnie)**

* **Only import data containing …** (reguła uwzględniania)
* **Exclude data containing …** (reguła wykluczania)

Użyj tego, jeśli chcesz zaimportować tylko określone wiersze (np. tylko te, które zawierają `SYNC`).

***

#### **Krok 3.4. Dane obrazów (jeśli plik CSV zawiera obrazy)**

Wybierz jedną opcję:

* **Add new images** (dodaje obrazy bez usuwania starych)
* **Upon creation product only** (dodaje obrazy tylko dla nowych produktów)
* **Overwrite current images** (zastępuje istniejące obrazy)

***

#### **Krok 3.5. Powiadomienia e-mail (opcjonalnie)**

Wybierz, kiedy chcesz otrzymywać e-maile:

* Na początku przesyłania
* Po zakończeniu przesyłania
* W przypadku błędu przesyłania

***

#### **Krok 3.6. Zaplanuj przesłanie**&#x20;

* **Run now** (import natychmiast)\
  (Mogą pojawić się inne opcje harmonogramu, w zależności od planu lub ustawień.)

Na koniec kliknij **Save** (w prawym górnym rogu).

***

## 🧪 Przykład: aktualizacja istniejących produktów + tworzenie nowych

**Przykładowy CSV**

| Handle              | Title               | Vendor     |
| ------------------- | ------------------- | ---------- |
| ceramic-table-lamp  | Ceramic Table Lamp  | ModernHome |
| wooden-floor-mirror | Wooden Floor Mirror | ModernHome |

**Ustawienia do wyboru**

* **Primary Key**: Product Handle
* **Column heading**: Handle
* **Matching & Imports**: Create new items if not exist and update current items that have the same primary key

**Wynik**

* Jeśli `ceramic-table-lamp` już istnieje → zostanie zaktualizowany
* Jeśli `wooden-floor-mirror` nie istnieje → zostanie utworzony

***

**🙋 Nadal potrzebujesz pomocy?**

Jeśli nadal potrzebujesz pomocy, skontaktuj się z nami pod adresem <hi@tipo.io>. Chętnie pomożemy.
