# Synchroniser les métachamps

Ce guide explique comment synchroniser les métachamps de votre boutique source vers votre boutique de destination dans l’application Tipo.

### ℹ️ Que sont les métachamps ?

* **Métachamps de produit**
* **Métachamps de variante** (si vous l’activez)

L’application Tipo peut synchroniser les métachamps pour :

* matière, guide des tailles, spécifications
* badges personnalisés (par ex. « best\_seller »)
* détails supplémentaires du produit utilisés par les thèmes ou les applications

Les métachamps sont des champs personnalisés de Shopify qui servent à stocker des données produit supplémentaires, telles que :

***

### ✅ **Types de métachamps pris en charge**

* Texte multiligne (Multi-line text)
* Texte enrichi (Rich text)
* Entier (Integer)
* Décimal (Decimal)
* Date et heure (Date and time)
* Date
* Dimension
* Volume
* Poids (Weight)
* Vrai ou faux (True or false)
* Évaluation (Rating)
* URL
* Montant (Money)
* Lien (Link)
* JSON

🚫 **Pas encore pris en charge :**\
Les types de référence (par ex. référence de produit, référence de collection) ne sont actuellement pas pris en charge.

***

### 🛠️ Étape 1 : configurer les métachamps sur la boutique source

1. Ouvrez l’application > cliquez sur **Paramètres (Settings)** > activez **Partager les métachamps (Share Metafields)**
2. Choisissez la ressource que vous souhaitez partager :
   * **Ressource produit (Product resource)** – Partager les métachamps de produit.
   * **Ressource variante (Variant resource)** – Partager les métachamps de variante.
3. Ajoutez des définitions de métachamps spécifiques pour limiter les métachamps partagés.
   * Cliquez sur l’icône **Parcourir les métachamps (Browse metafields)**, ou
   * Saisissez la définition du métachamp au format :

     ```
     namespace.key
     ```

     Par exemple :

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

***

### 🛠️ Étape 2 : configurer les métachamps sur la boutique de destination

1. Ouvrez l’application > cliquez sur **Boutiques (Stores)** > cliquez sur l’URL de la boutique source pour ouvrir les détails de la connexion

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

2. Activez **Synchronisation des métachamps (Metafields sync)**
3. Choisissez ce qu’il faut synchroniser

   Sous **Données autorisées (Allow data)**, sélectionnez une option ou les deux :

   * **Ressource produit** → synchroniser les métachamps de produit
   * **Ressource variante** → synchroniser les métachamps de variante
4. Cliquez sur l’icône de recherche à droite pour voir tous les métachamps pris en charge > cliquez sur le bouton **Sélectionner un métachamp valide à synchroniser (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. Cliquez sur **Enregistrer** pour enregistrer les modifications

***

### &#x20;🔄 Ce qui se passe pendant la synchronisation

#### **1) Si la boutique de destination n’a pas la définition du métachamp**

L’application crée automatiquement la définition du métachamp dans la boutique de destination (lorsque nécessaire).

Une fois celle-ci créée, les valeurs de métachamps synchronisées apparaissent sur le produit ou la variante dans la boutique de destination.

#### **2) Si des métachamps existent mais ne sont pas « structurés » (métachamps non structurés)**

Dans certains cas, les métachamps peuvent être synchronisés même s’ils n’ont pas été entièrement définis ou structurés dans la boutique de destination.

Pour les consulter dans l’admin Shopify :

* **ouvrez** **Paramètres → Métachamps et métaobjets (Settings → Metafields and metaobjects)** de la boutique
* Choisissez **Produit (Product)** (ou **Variante (Variant)**)
* Ouvrez **Voir les métachamps non structurés (View unstructured metafields)**

💡 Astuce : vous pourrez définir ou structurer manuellement ces métachamps plus tard afin de garder les données de votre boutique propres et cohérentes.

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

#### **3) Si la boutique source n’a aucune valeur, la destination n’est pas écrasée**

Si un métachamp existe dans la destination mais que la valeur de la source est vide, Tipo Sync n’écrase pas la valeur de la destination.

#### **4) Les types de données doivent correspondre (très important)**

Les types de données des métachamps doivent correspondre exactement entre la source et la destination.

Exemples de types de données qui ne correspondent pas :

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

⚠️ Si les types de données ne correspondent pas, la synchronisation peut échouer ou ignorer ce métachamp.

***

### 📌 Exemple : synchroniser un métachamp de produit – « Material » (matière)

Vous souhaitez synchroniser un **métachamp de produit personnalisé** appelé **Material** (par ex. « Cotton », « Leather », « Wool ») de votre **boutique source** vers votre **boutique de destination** à l’aide de notre application.

#### **Étape 1 : définir le métachamp dans Shopify**

Dans votre **boutique source** :

1. Allez dans l’**admin Shopify >** ouvrez **Paramètres > Métachamps et métaobjets** de la boutique > choisissez **Produit** (ou **Variante**)
2. Cliquez sur **Ajouter une définition (Add definition)** (si elle n’est pas déjà créée) > remplissez la définition du métachamp :
   * **Nom (Name)** : Material
   * **Espace de noms (Namespace)** : `custom`
   * **Clé (Key)** : `material`
   * **Type** : Texte sur une seule ligne (Single line text)

\=>  Vous obtenez ainsi la clé complète du métachamp : `custom.material`

Répétez cette étape dans votre **boutique de destination** (la clé et le type doivent être identiques).

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

#### **Étape 2 : ajouter des données de métachamp aux produits**

Dans votre **boutique source**, ouvrez un produit et faites défiler jusqu’à **Métachamps (Metafields)** > sous **Material**, saisissez : `Cotton`

Ce produit possède désormais le métachamp `custom.material = "Cotton"`.

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

#### **Étape 3 : configurer la synchronisation dans l’application Tipo**&#x20;

* Ouvrez notre application dans la **boutique de destination** > allez dans **Configuration de la connexion (Connect Configuration) > Synchronisation des métachamps**
* Choisissez **Métachamps spécifiques (Specific Metafields) >** saisissez exactement la clé du métachamp : `custom.material`&#x20;

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

**Résultat**

* Notre application trouvera `custom.material` dans la boutique source
* S’il **n’existe pas** dans le produit de la destination, l’application le **créera**\
  \=>   Résultat : `custom.material = "Cotton"` dans les deux boutiques
* S’il existe dans la destination mais que la source est vide, nous **n’écrasons pas** la valeur

***

### ❓FAQ

#### Q1 : comment définir `namespace.key` dans votre boutique ?

Pour synchroniser un métachamp spécifique, vous devez saisir la **clé de définition du métachamp** au format : `namespace.key` (par exemple : `custom.color`).

Voici comment la trouver dans votre admin Shopify :

1. Allez dans votre admin Shopify > accédez à **Paramètres > Données personnalisées > Produits (Settings > Custom Data > Products)**
2. Cliquez sur le métachamp que vous souhaitez synchroniser\
   → Vous verrez les valeurs **Espace de noms (Namespace)** et **Clé (Key)**
3. Combinez-les au format : `namespace.key`\
   → Exemple : `custom.description`

#### Q2 : pourquoi mes métachamps ne se synchronisent-ils pas ?

Si vos métachamps ne se synchronisent pas correctement, l’une des raisons suivantes peut en être la cause :

1. **La synchronisation des métachamps n’est pas activée**\
   Assurez-vous que la synchronisation des métachamps est activée dans les deux boutiques :
   * Activez **Partager les métachamps** dans la **boutique source**.
   * Activez **Recevoir les métachamps (Receive Metafields)** dans la **boutique de destination**.

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

2. **La clé de définition du métachamp n’est pas ajoutée**

En plus d’activer la synchronisation des métachamps, vous devez aussi ajouter la **clé de définition du métachamp (namespace.key)** que vous souhaitez synchroniser.

* Allez dans **Paramètres → Partager les métachamps**
* Vérifiez que **Activer (Enable)** est coché
* Sous **Données autorisées**, ajoutez la définition du métachamp au format :\
  `namespace.key`\
  Exemple : `custom.material`&#x20;

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

3. **Types de métachamps non pris en charge**\
   Certains types de données de métachamps ne sont pas pris en charge, comme les **types de référence** ou les **métaobjets**.

Rouge : métachamps non pris en charge qui ne peuvent pas être synchronisés par l’application

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

4. **Types de métachamps différents entre les boutiques**\
   Le métachamp de votre source et celui de votre destination doivent avoir **le même type de données et la même structure**.\
   Les différences courantes sont :

* L’un des métachamps est de type **Texte sur une seule ligne**, tandis que l’autre est de type **Texte multiligne**.
* L’un des métachamps utilise **Valeur unique (Single value)**, tandis que l’autre utilise **Liste de valeurs (List of values)**.

Pour résoudre ces problèmes, vérifiez que les métachamps des deux boutiques ont le même **espace de noms**, la même **clé** et le même **type de données**, puis relancez la synchronisation.

***

**🙋 Besoin d’aide ?**

Si vous avez encore besoin d’aide, n’hésitez pas à nous écrire à <hi@tipo.io>. Nous serons ravis de vous accompagner.
