# Synchronizacja metapól

Ten przewodnik wyjaśnia, jak synchronizować metapola z Source store do Destination store w aplikacji Tipo.

### ℹ️ Czym są metapola?

* **Metapola produktów**
* **Metapola wariantów** (jeśli je włączysz)

Aplikacja Tipo może synchronizować metapola dla:

* materiału, tabeli rozmiarów, specyfikacji
* niestandardowych oznaczeń (np. „best\_seller”)
* dodatkowych szczegółów produktu wykorzystywanych przez motywy/aplikacje

Metapola to niestandardowe pola w Shopify, służące do przechowywania dodatkowych danych o produkcie, takich jak:

***

### ✅ **Obsługiwane typy metapól**

* Multi-line text
* Rich text
* Integer
* Decimal
* Date and time
* Date
* Dimension
* Volume
* Weight
* True or false
* Rating
* URL
* Money
* Link
* JSON

🚫 **Jeszcze nieobsługiwane:**\
Typy referencyjne (np. referencja do produktu, referencja do kolekcji) nie są obecnie obsługiwane.

***

### 🛠️ Krok 1: Konfiguracja metapól w Source Store

1. Otwórz aplikację > kliknij **Settings** > włącz **Share Metafields**
2. Wybierz zasób, który chcesz udostępnić:
   * **Product resource** – udostępnij metapola produktów.
   * **Variant resource** – udostępnij metapola wariantów.
3. Dodaj konkretne definicje metapól, aby ograniczyć, które metapola są udostępniane.
   * Kliknij ikonę **Browse metafields** lub
   * Wpisz definicję metapola w formacie:

     ```
     namespace.key
     ```

Na przykład:

     ```
     custom.materialseo.titlespecifications.weight
     ```
4. Click **Save** to update the changes

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

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

***

### 🛠️ Krok 2: Konfiguracja metapól w Destination Store

1. Otwórz aplikację > kliknij **Stores** > kliknij adres URL sklepu źródłowego, aby otworzyć szczegóły połączenia

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

2. Włącz **Metafields sync**
3. Wybierz, co synchronizować

W sekcji **Allow data** zaznacz jedną lub obie opcje:

* **Product Resource** → synchronizuj metapola produktów
   * **Variant Resource** → synchronizuj metapola wariantów
4. Kliknij ikonę wyszukiwania po prawej stronie, aby zobaczyć wszystkie obsługiwane metapola > kliknij przycisk **Select valid metafield to sync**&#x20;

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

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

5. Kliknij **Save**, aby zapisać zmiany

***

### &#x20;🔄 Co dzieje się podczas synchronizacji

#### **1) Jeśli Destination store nie ma definicji metapola**

Aplikacja automatycznie utworzy definicję metapola w Destination store (w razie potrzeby).

Po jej utworzeniu zsynchronizowane wartości metapól pojawią się przy produkcie/wariancie w Destination store.

#### **2) Jeśli metapola istnieją, ale nie są „ustrukturyzowane” (Unstructured metafields)**

W niektórych przypadkach metapola mogą się zsynchronizować, nawet jeśli nie zostały w pełni zdefiniowane/ustrukturyzowane w Destination store.

Aby je przejrzeć w Shopify Admin:

* **Otwórz** **Settings sklepu → Metafields and metaobjects**
* Wybierz **Product** (lub **Variant**)
* Otwórz **View unstructured metafields**

💡 Wskazówka: Możesz później ręcznie zdefiniować/ustrukturyzować te metapola, aby dane w sklepie były uporządkowane i spójne.

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

#### **3) Jeśli Source store nie ma wartości, Destination nie zostanie nadpisany**

Jeśli metapole istnieje w Destination, ale wartość w Source jest pusta, Tipo Sync nie nadpisze wartości w Destination.

#### **4) Typy danych muszą się zgadzać (bardzo ważne)**

Typy danych metapól muszą dokładnie odpowiadać sobie w Source i Destination.

Przykłady niezgodności typów danych:

* `single_line_text_field` vs `multi_line_text_field`
* `number_integer` vs `number_decimal`
* `product_reference` vs `text`

⚠️ Jeśli typy danych się nie zgadzają, synchronizacja może się nie powieść lub pominie dane metapole.

***

### 📌 Przykład: Synchronizacja metapola produktu – „Material”

Chcesz zsynchronizować **niestandardowe metapole produktu** o nazwie **Material** (np. „Cotton”, „Leather”, „Wool”) z **Source Store** do **Destination Store** za pomocą naszej aplikacji.

#### **Krok 1: Zdefiniuj metapole w Shopify**

W Twoim **Source Store**:

1. Przejdź do **Shopify Admin >** otwórz **Settings sklepu > Metafields and metaobjects** > wybierz **Product** (lub **Variant**)
2. Kliknij **Add definition** (jeśli nie została jeszcze utworzona) > wypełnij definicję metapola:
   * **Name**: Material
   * **Namespace**: `custom`
   * **Key**: `material`
   * **Type**: Single line text

\=>  To daje pełny klucz metapola: `custom.material`

Powtórz ten krok w swoim **Destination Store** (musi mieć ten sam klucz i typ).

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

#### **Krok 2: Dodaj dane metapola do produktów**

W Twoim **Source Store** otwórz produkt, przewiń do **Metafields** > w polu **Material** wpisz: `Cotton`

Ten produkt ma teraz metapole `custom.material = "Cotton"`.

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

#### **Krok 3: Skonfiguruj synchronizację w aplikacji Tipo**&#x20;

* Otwórz naszą aplikację w **Destination Store** > przejdź do Connect Configuration **> Metafield Sync**
* Wybierz **Specific Metafields > w**pisz klucz metapola dokładnie tak: `custom.material`&#x20;

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

**Wynik**

* Nasza aplikacja znajdzie `custom.material` w Source Store
* Jeśli **nie istnieje** w produkcie w Destination, aplikacja **go utworzy**\
  \=>   Wynik: `custom.material = "Cotton"` w obu sklepach
* Jeśli istnieje w Destination, a w Source jest pusty, **nie nadpisujemy** wartości

***

### ❓FAQ

#### Q1: Jak ustawić `namespace.key` w sklepie?

Aby zsynchronizować konkretne metapole, musisz wpisać **klucz definicji metapola** w formacie: `namespace.key` (na przykład: `custom.color`).

Oto jak go znaleźć w panelu Shopify:

1. Przejdź do Shopify Admin > wybierz **Settings > Custom Data > Products**
2. Kliknij metapole, które chcesz zsynchronizować\
   → Zobaczysz wartości **Namespace** i **Key**
3. Połącz je w formacie: `namespace.key`\
   → Przykład: `custom.description`

#### Q2: Dlaczego moje metapola się nie synchronizują?

Jeśli metapola nie synchronizują się poprawnie, przyczyną może być jedna z poniższych sytuacji:

1. **Synchronizacja metapól nie jest włączona**\
   Upewnij się, że synchronizacja metapól jest włączona w obu sklepach:
   * Włącz **Share Metafields** w **Source Store**.
   * Włącz **Receive Metafields** w **Destination Store**.

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

2. **Nie dodano klucza definicji metapola**

Oprócz włączenia synchronizacji metapól musisz także dodać **klucz definicji metapola (namespace.key)**, który chcesz synchronizować.

* Przejdź do **Settings → Share Metafields**
* Upewnij się, że **Enable** jest zaznaczone
* W sekcji **Allow data** dodaj definicję metapola w tym formacie:\
  `namespace.key`\
  Przykład: `custom.material`&#x20;

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

3. **Nieobsługiwane typy metapól**\
   Niektórych typów danych metapól nie obsługujemy, na przykład **Reference types** lub **MetaObjects**.

Czerwony: nieobsługiwane metapola, których aplikacja nie może zsynchronizować

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

4. **Niezgodne typy metapól między sklepami**\
   Metapole w Source i Destination musi mieć **ten sam typ danych i strukturę**.\
   Typowe niezgodności to:

* Jedno metapole to **Single line text**, a drugie **Multi-line text**.
* Jedno metapole używa **Single value**, a drugie **List of values**.

Aby naprawić te problemy, upewnij się, że metapola w obu sklepach mają ten sam **namespace**, **key** i **typ danych**, a następnie spróbuj ponownie.

***

**🙋 Nadal potrzebujesz pomocy?**

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