# Synkroniser metafelt

Denne veiledningen forklarer hvordan du synkroniserer metafelt fra Source store til Destination store i Tipo-appen.

### ℹ️ Hva er metafelt?

* **Produktmetafelt**
* **Variantmetafelt** (hvis du aktiverer det)

Tipo-appen kan synkronisere metafelt for:

* materiale, størrelsesguide, spesifikasjoner
* egendefinerte merker (f.eks. «best\_seller»)
* ekstra produktdetaljer som brukes av temaer/apper

Metafelt er egendefinerte felt i Shopify som brukes til å lagre ekstra produktdata, for eksempel:

***

### ✅ **Støttede metafelttyper**

* Flerlinjers tekst
* Rik tekst
* Heltall
* Desimaltall
* Dato og klokkeslett
* Dato
* Dimensjon
* Volum
* Vekt
* Sann eller usann
* Vurdering
* URL
* Penger
* Lenke
* JSON

🚫 **Støttes ikke ennå:**\
Referansetyper (f.eks. produktreferanse, kolleksjonsreferanse) støttes foreløpig ikke.

***

### 🛠️ Trinn 1: Konfigurer metafelt i Source Store

1. Åpne appen > klikk på **Settings** > slå på **Share Metafields**
2. Velg ressursen du vil dele:
   * **Product resource** – Del produktmetafelt.
   * **Variant resource** – Del variantmetafelt.
3. Legg til spesifikke metafeltdefinisjoner for å begrense hvilke metafelt som deles.
   * Klikk på ikonet **Browse metafields**, eller
   * Skriv inn metafeltdefinisjonen i formatet:

     ```
     namespace.key
     ```

For eksempel:

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

***

### 🛠️ Trinn 2: Konfigurer metafelt i Destination Store

1. Åpne appen > klikk på **Stores** > klikk på nettadressen til Source store for å åpne tilkoblingsdetaljene

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

2. Slå på **Metafields sync**
3. Velg hva som skal synkroniseres

Under **Allow data** velger du ett av alternativene eller begge:

* **Product Resource** → synkroniser produktmetafelt
   * **Variant Resource** → synkroniser variantmetafelt
4. Klikk på søkeikonet til høyre for å se alle støttede metafelt > klikk på knappen **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. Klikk på **Save** for å lagre endringene

***

### &#x20;🔄 Hva skjer under synkroniseringen

#### **1) Hvis Destination store ikke har metafeltdefinisjonen**

Appen oppretter automatisk metafeltdefinisjonen i Destination store (ved behov).

Etter at den er opprettet, vises de synkroniserte metafeltverdiene på produktet/varianten i Destination store.

#### **2) Hvis metafelt finnes, men ikke er «strukturerte» (ustrukturerte metafelt)**

I noen tilfeller kan metafelt synkroniseres selv om de ikke er fullt ut definert/strukturert i Destination store.

Slik gjennomgår du dem i Shopify Admin:

* **åpne** butikk**innstillinger → Metafields and metaobjects**
* Velg **Product** (eller **Variant**)
* Åpne **View unstructured metafields**

💡 Tips: Du kan definere/strukturere disse metafeltene manuelt senere for å holde butikkdataene ryddige og konsistente.

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

#### **3) Hvis Source store ikke har noen verdi, overskrives ikke Destination**

Hvis et metafelt finnes i Destination, men verdien i Source er tom, overskriver ikke Tipo Sync verdien i Destination.

#### **4) Datatyper må samsvare (veldig viktig)**

Metafeltenes datatyper må samsvare nøyaktig mellom Source og Destination.

Eksempler på datatyper som ikke samsvarer:

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

⚠️ Hvis datatypene ikke samsvarer, kan synkroniseringen mislykkes eller hoppe over det metafeltet.

***

### 📌 Eksempel: Synkronisere et produktmetafelt – «Material»

Du vil synkronisere et **egendefinert produktmetafelt** som heter **Material** (f.eks. «Cotton», «Leather», «Wool») fra **Source Store** til **Destination Store** ved hjelp av appen vår.

#### **Trinn 1: Definer metafeltet i Shopify**

I **Source Store**:

1. Gå til **Shopify Admin >** åpne butikkens **Settings > Metafields and metaobjects** > velg **Product** (eller **Variant**)
2. Klikk på **Add definition** (hvis den ikke allerede er opprettet) > fyll ut metafeltdefinisjonen:
   * **Name**: Material
   * **Namespace**: `custom`
   * **Key**: `material`
   * **Type**: Single line text

\=>  Dette gir deg hele metafeltnøkkelen: `custom.material`

Gjenta dette trinnet i **Destination Store** (må ha samme nøkkel og type).

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

#### **Trinn 2: Legg til metafeltdata på produkter**

Gå til et produkt i **Source Store** og rull ned til **Metafields**  > Under **Material** skriver du inn: `Cotton`

Dette produktet har nå metafeltet `custom.material = "Cotton"`.

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

#### **Trinn 3: Konfigurer synkronisering i Tipo-appen**&#x20;

* Åpne appen vår i **Destination Store** > gå til Connect Configuration **> Metafield Sync**
* Velg **Specific Metafields > s**kriv inn metafeltnøkkelen nøyaktig: `custom.material`&#x20;

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

**Resultat**

* Appen vår finner `custom.material` i Source Store
* Hvis det **ikke finnes** på produktet i Destination, **oppretter** appen det\
  \=>   Resultat: `custom.material = "Cotton"` i begge butikker
* Hvis det finnes i Destination, men Source er tomt, **overstyrer vi ikke** verdien

***

### ❓Vanlige spørsmål

#### Q1: Hvordan angir jeg `namespace.key` i butikken din?

For å synkronisere et bestemt metafelt må du skrive inn **metafeltdefinisjonsnøkkelen** i dette formatet: `namespace.key` (for eksempel: `custom.color`).

Slik finner du den i Shopify admin:

1. Gå til Shopify Admin >naviger til **Settings > Custom Data > Products**
2. Klikk på metafeltet du vil synkronisere\
   → Du ser verdiene for **Namespace** og **Key**
3. Kombiner dem i dette formatet: `namespace.key`\
   → Eksempel: `custom.description`

#### Q2: Hvorfor synkroniseres ikke metafeltene mine?

Hvis metafeltene dine ikke synkroniseres riktig, kan det skyldes en av følgende årsaker:

1. **Metafeltsynkronisering er ikke aktivert**\
   Sørg for at metafeltsynkronisering er slått på for begge butikker:
   * Aktiver **Share Metafields** i **Source Store**.
   * Aktiver **Receive Metafields** i **Destination Store**.

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

2. **Metafeltdefinisjonsnøkkelen er ikke lagt til**

I tillegg til å aktivere metafeltsynkronisering må du også legge til **metafeltdefinisjonsnøkkelen (namespace.key)** du vil synkronisere.

* Gå til **Settings → Share Metafields**
* Sørg for at **Enable** er avkrysset
* Under **Allow data** legger du til metafeltdefinisjonen i dette formatet:\
  `namespace.key`\
  Eksempel: `custom.material`&#x20;

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

3. **Metafelttyper som ikke støttes**\
   Noen metafeltdatatyper støttes ikke, for eksempel **Reference types** eller **MetaObjects**.

Rød: Metafelt som ikke støttes og ikke kan synkroniseres av appen

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

4. **Metafelttyper som ikke samsvarer mellom butikkene**\
   Metafeltet i Source og Destination må ha **samme datatype og struktur**.\
   Vanlige avvik er:

* Det ene metafeltet er **Single line text**, mens det andre er **Multi-line text**.
* Det ene metafeltet bruker **Single value**, mens det andre bruker **List of values**.

For å løse disse problemene må du bekrefte at metafeltene i begge butikker har samme **namespace**, **key** og **datatype**, og deretter prøve å synkronisere på nytt.

***

**🙋 Trenger du fortsatt hjelp?**

Hvis du fortsatt trenger hjelp, er du velkommen til å kontakte oss på <hi@tipo.io>. Vi hjelper deg gjerne videre.
