# Metafields synchroniseren

Deze handleiding legt uit hoe je metafields van je Source store naar je Destination store synchroniseert in de Tipo-app.

### ℹ️ Wat zijn metafields?

* **Product metafields**
* **Variant metafields** (als je dit inschakelt)

De Tipo-app kan metafields synchroniseren voor:

* materiaal, maattabel, specificaties
* aangepaste badges (bijv. “best\_seller”)
* extra productdetails die door thema's of apps worden gebruikt

Metafields zijn aangepaste velden in Shopify die worden gebruikt om extra productgegevens op te slaan, zoals:

***

### ✅ **Ondersteunde metafieldtypen**

* Meerregelige tekst
* Opgemaakte tekst
* Geheel getal
* Decimaal
* Datum en tijd
* Datum
* Afmeting
* Volume
* Gewicht
* Waar of onwaar
* Beoordeling
* URL
* Geld
* Link
* JSON

🚫 **Nog niet ondersteund:**\
Referentietypen (bijv. productreferentie, collectiereferentie) worden momenteel niet ondersteund.

***

### 🛠️ Stap 1: Metafields configureren in de Source store

1. Open de app > klik op **Settings** > zet **Share Metafields** aan
2. Kies de resource die je wilt delen:
   * **Product resource** – Deel productmetafields.
   * **Variant resource** – Deel variantmetafields.
3. Voeg specifieke metafield-definities toe om te beperken welke metafields worden gedeeld.
   * Klik op het pictogram **Browse metafields**, of
   * Voer de metafield-definitie in het volgende formaat in:

     ```
     namespace.key
     ```

Bijvoorbeeld:

     ```
     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>

***

### 🛠️ Stap 2: Metafields configureren in de Destination store

1. Open de app > klik op **Stores** > klik op de URL van de source store om de verbindingsdetails te openen

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

2. Zet **Metafields sync** aan
3. Kies wat je wilt synchroniseren

Selecteer onder **Allow data** een of beide:

* **Product Resource** → productmetafields synchroniseren
   * **Variant Resource** → variantmetafields synchroniseren
4. Klik op het zoekpictogram rechts om alle ondersteunde metafields te zien > klik op de knop **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. Klik op **Save** om de wijzigingen op te slaan

***

### &#x20;🔄 Wat er gebeurt tijdens de synchronisatie

#### **1) Als de Destination store de metafield-definitie niet heeft**

De app maakt de metafield-definitie automatisch aan in de Destination store (indien nodig).

Nadat deze is aangemaakt, verschijnen de gesynchroniseerde metafieldwaarden op het product of de variant in de Destination store.

#### **2) Als metafields bestaan maar niet “gestructureerd” zijn (ongestructureerde metafields)**

In sommige gevallen kunnen metafields worden gesynchroniseerd, ook als ze in de Destination store niet volledig zijn gedefinieerd of gestructureerd.

Om ze in Shopify Admin te bekijken:

* **Ga naar** store **Settings → Metafields and metaobjects**
* Kies **Product** (of **Variant**)
* Open **View unstructured metafields**

💡 Tip: Je kunt deze metafields later handmatig definiëren en structureren om je winkelgegevens schoon en consistent te houden.

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

#### **3) Als de Source store geen waarde heeft, wordt de Destination niet overschreven**

Als een metafield in de Destination store bestaat maar de waarde in de Source store leeg is, overschrijft Tipo Sync de waarde in de Destination store niet.

#### **4) Gegevenstypen moeten overeenkomen (zeer belangrijk)**

Metafield-gegevenstypen moeten exact overeenkomen tussen Source en Destination.

Voorbeelden van niet-overeenkomende gegevenstypen:

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

⚠️ Als de gegevenstypen niet overeenkomen, kan de synchronisatie mislukken of wordt die metafield overgeslagen.

***

### 📌 Voorbeeld: een productmetafield synchroniseren – “Material”

Je wilt een **aangepaste productmetafield** met de naam **Material** (bijv. “Cotton”, “Leather”, “Wool”) van je **Source Store** naar je **Destination Store** synchroniseren met onze app.

#### **Stap 1: Definieer de metafield in Shopify**

In je **Source Store**:

1. Ga naar **Shopify Admin >** open de winkel **Settings > Metafields and metaobjects** > kies **Product** (of **Variant**)
2. Klik op **Add definition** (als deze nog niet is aangemaakt) > vul de metafield-definitie in:
   * **Name**: Material
   * **Namespace**: `custom`
   * **Key**: `material`
   * **Type**: Single line text

\=>  Dit geeft je de volledige metafieldsleutel: `custom.material`

Herhaal deze stap in je **Destination Store** (moet dezelfde sleutel en hetzelfde type hebben).

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

#### **Stap 2: Voeg metafieldgegevens toe aan producten**

Ga in je **Source Store** naar een product en scrol naar beneden naar **Metafields** > voer onder **Material** in: `Cotton`

Dit product heeft nu de metafield `custom.material = "Cotton"`.

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

#### **Stap 3: Synchronisatie configureren in de Tipo-app**&#x20;

* Open onze app in de **Destination Store** > ga naar Connect Configuration **> Metafield Sync**
* Kies **Specific Metafields > v**oer de metafieldsleutel exact in: `custom.material`&#x20;

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

**Resultaat**

* Onze app vindt `custom.material` in de Source Store
* Als deze **niet bestaat** in het Destination-product, maakt de app deze **aan**\
  \=>   Resultaat: `custom.material = "Cotton"` in beide winkels
* Als deze in de Destination store bestaat maar de Source leeg is, **overschrijven we** de waarde **niet**

***

### ❓Veelgestelde vragen

#### V1: Hoe stel ik `namespace.key` in je winkel in?

Om een specifieke metafield te synchroniseren, voer je de **metafield-definitiesleutel** in dit formaat in: `namespace.key` (bijvoorbeeld: `custom.color`).

Zo vind je dit in je Shopify-beheeromgeving:

1. Ga naar je Shopify Admin > navigeer naar **Settings > Custom Data > Products**
2. Klik op de metafield die je wilt synchroniseren\
   → Je ziet de waarden **Namespace** en **Key**
3. Combineer ze in dit formaat: `namespace.key`\
   → Voorbeeld: `custom.description`

#### V2: Waarom worden mijn metafields niet gesynchroniseerd?

Als je metafields niet correct worden gesynchroniseerd, kan dat een van de volgende oorzaken hebben:

1. **Metafieldsynchronisatie is niet ingeschakeld**\
   Zorg dat metafieldsynchronisatie voor beide winkels is ingeschakeld:
   * Schakel **Share Metafields** in de **Source Store** in.
   * Schakel **Receive Metafields** in de **Destination Store** in.

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

2. **Metafield-definitiesleutel is niet toegevoegd**

Naast het inschakelen van metafieldsynchronisatie moet je ook de **metafield-definitiesleutel (namespace.key)** toevoegen die je wilt synchroniseren.

* Ga naar **Settings → Share Metafields**
* Zorg dat **Enable** is aangevinkt
* Voeg onder **Allow data** de metafield-definitie in dit formaat toe:\
  `namespace.key`\
  Voorbeeld: `custom.material`&#x20;

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

3. **Niet-ondersteunde metafieldtypen**\
   Sommige metafield-gegevenstypen worden niet ondersteund, zoals **Reference types** of **MetaObjects**.

Rood: niet-ondersteunde metafields die niet door de app kunnen worden gesynchroniseerd

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

4. **Niet-overeenkomende metafieldtypen tussen winkels**\
   De metafield in je Source en Destination moet **hetzelfde gegevenstype en dezelfde structuur** hebben.\
   Veelvoorkomende verschillen zijn:

* Eén metafield is **Single line text**, terwijl de andere **Multi-line text** is.
* Eén metafield gebruikt **Single value**, terwijl de andere **List of values** gebruikt.

Om deze problemen op te lossen, controleer je of de metafields in beide winkels dezelfde **namespace**, **key** en **gegevenstype** hebben, en probeer daarna opnieuw te synchroniseren.

***

**🙋 Heb je nog steeds ondersteuning nodig?**

Als je nog steeds hulp nodig hebt, neem dan gerust contact met ons op via <hi@tipo.io>. We helpen je graag verder.
