# Synkronisér metafelter

Denne vejledning forklarer, hvordan du synkroniserer metafelter fra din kildebutik til din destinationsbutik i Tipo-appen.

### ℹ️ Hvad er metafelter?

* **Produktmetafelter**
* **Variantmetafelter** (hvis du aktiverer det)

Tipo-appen kan synkronisere metafelter til:

* materiale, størrelsesguide, specifikationer
* tilpassede badges (f.eks. "best\_seller")
* ekstra produktoplysninger, som temaer/apps bruger

Metafelter er brugerdefinerede felter i Shopify, der bruges til at gemme ekstra produktdata, f.eks.:

***

### ✅ **Understøttede metafelttyper**

* Tekst med flere linjer
* Rich text
* Heltal
* Decimaltal
* Dato og klokkeslæt
* Dato
* Dimension
* Volumen
* Vægt
* Sandt eller falsk
* Vurdering
* URL
* Penge
* Link
* JSON

🚫 **Understøttes endnu ikke:**\
Referencetyper (f.eks. produktreference, kollektionsreference) understøttes ikke i øjeblikket.

***

### 🛠️ Trin 1: Konfigurér metafelter i kildebutikken

1. Åbn appen > klik på **Indstillinger (Settings)** > slå **Del metafelter (Share Metafields)** til
2. Vælg den ressource, du vil dele:
   * **Produktressource (Product resource)** – Del produktmetafelter.
   * **Variantressource (Variant resource)** – Del variantmetafelter.
3. Tilføj specifikke metafeltdefinitioner for at begrænse, hvilke metafelter der deles.
   * Klik på ikonet **Gennemse metafelter (Browse metafields)**, eller
   * Indtast metafeltdefinitionen 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>

***

### 🛠️ Trin 2: Konfigurér metafelter i destinationsbutikken

1. Åbn appen > klik på **Butikker (Stores)** > klik på kildebutikkens URL for at åbne forbindelsens detaljer

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

2. Slå **Metafeltsynkronisering (Metafields sync)** til
3. Vælg, hvad der skal synkroniseres

   Under **Tillad data (Allow data)** skal du vælge en af eller begge:

   * **Produktressource (Product Resource)** → synkronisér produktmetafelter
   * **Variantressource (Variant Resource)** → synkronisér variantmetafelter
4. Klik på søgeikonet til højre for at se alle understøttede metafelter > klik på knappen **Vælg gyldigt metafelt til synkronisering (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 på **Gem** for at opdatere ændringerne

***

### &#x20;🔄 Hvad sker der under synkroniseringen

#### **1) Hvis destinationsbutikken ikke har metafeltdefinitionen**

Appen opretter automatisk metafeltdefinitionen i destinationsbutikken (når det er nødvendigt).

Når den er oprettet, vises de synkroniserede metafeltværdier på produktet/varianten i destinationsbutikken.

#### **2) Hvis metafelter findes, men ikke er "strukturerede" (ustrukturerede metafelter)**

I nogle tilfælde kan metafelter blive synkroniseret, selvom de ikke er fuldt defineret/struktureret i destinationsbutikken.

Sådan gennemser du dem i Shopify Admin:

* **åbn** butikkens **Indstillinger → Metafelter og metaobjekter**
* Vælg **Produkt** (eller **Variant**)
* Åbn **Se ustrukturerede metafelter**

💡 Tip: Du kan manuelt definere/strukturere disse metafelter senere, så dine butiksdata forbliver ryddelige og konsistente.

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

#### **3) Hvis kildebutikken ikke har nogen værdi, overskrives destinationen ikke**

Hvis et metafelt findes i destinationsbutikken, men kildeværdien er tom, overskriver Tipo Sync ikke værdien i destinationsbutikken.

#### **4) Datatyperne skal matche (meget vigtigt)**

Metafeltets datatyper skal matche præcist mellem kildebutikken og destinationsbutikken.

Eksempler på datatyper, der ikke matcher:

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

⚠️ Hvis datatyperne ikke matcher, kan synkroniseringen mislykkes, eller metafeltet kan blive sprunget over.

***

### 📌 Eksempel: Synkronisering af et produktmetafelt – "Material"

Du vil synkronisere et **brugerdefineret produktmetafelt** kaldet **Material** (f.eks. "Cotton", "Leather", "Wool") fra din **kildebutik** til din **destinationsbutik** med vores app.

#### **Trin 1: Definér metafeltet i Shopify**

I din **kildebutik**:

1. Gå til **Shopify Admin >** åbn butikkens **Indstillinger > Metafelter og metaobjekter** > vælg **Produkt** (eller **Variant**)
2. Klik på **Tilføj definition** (hvis den ikke allerede er oprettet) > udfyld metafeltdefinitionen:
   * **Navn**: Material
   * **Namespace**: `custom`
   * **Nøgle**: `material`
   * **Type**: Tekst på én linje

\=>  Så får du den fulde metafeltnøgle: `custom.material`

Gentag dette trin i din **destinationsbutik** (nøglen og typen skal være de samme).

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

#### **Trin 2: Tilføj metafeltdata til produkter**

Gå til et produkt i din **kildebutik**, og rul ned til **Metafelter**  > Indtast under **Material**: `Cotton`

Produktet har nu metafeltet `custom.material = "Cotton"`.

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

#### **Trin 3: Konfigurér synkronisering i Tipo-appen**&#x20;

* Åbn vores app i **destinationsbutikken** > gå til forbindelseskonfigurationen **> Metafeltsynkronisering**
* Vælg **Specifikke metafelter > i**ndtast metafeltnøglen præcist: `custom.material`&#x20;

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

**Resultat**

* Vores app finder `custom.material` i kildebutikken
* Hvis det **ikke findes** på destinationsproduktet, **opretter appen det**\
  \=>   Resultat: `custom.material = "Cotton"` i begge butikker
* Hvis det findes i destinationsbutikken, men kilden er tom, **overskriver vi ikke** værdien

***

### ❓Ofte stillede spørgsmål

#### Q1: Hvordan angiver jeg `namespace.key` i din butik?

For at synkronisere et bestemt metafelt skal du indtaste **metafeltets definitionsnøgle** i formatet: `namespace.key` (for eksempel: `custom.color`).

Sådan finder du den i din Shopify Admin:

1. Gå til din Shopify Admin > naviger til **Indstillinger > Brugerdefinerede data > Produkter**
2. Klik på det metafelt, du vil synkronisere\
   → Du ser værdierne for **Namespace** og **Nøgle**
3. Sæt dem sammen i formatet: `namespace.key`\
   → Eksempel: `custom.description`

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

Hvis dine metafelter ikke synkroniseres korrekt, kan det skyldes en af følgende årsager:

1. **Metafeltsynkronisering er ikke aktiveret**\
   Sørg for, at metafeltsynkronisering er slået til i begge butikker:
   * Aktivér **Del metafelter** i **kildebutikken**.
   * Aktivér **Modtag metafelter (Receive Metafields)** i **destinationsbutikken**.

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

2. **Metafeltets definitionsnøgle er ikke tilføjet**

Ud over at aktivere metafeltsynkronisering skal du også tilføje den **metafeltdefinitionsnøgle (namespace.key)**, du vil synkronisere.

* Gå til **Indstillinger → Del metafelter**
* Sørg for, at **Aktivér (Enable)** er afkrydset
* Tilføj metafeltdefinitionen under **Tillad data** i formatet:\
  `namespace.key`\
  Eksempel: `custom.material`&#x20;

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

3. **Metafelttyper, der ikke understøttes**\
   Nogle metafelttyper understøttes ikke, f.eks. **referencetyper** eller **metaobjekter**.

Rød: Metafelter, der ikke understøttes, og som appen ikke kan synkronisere

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

4. **Metafelttyper, der ikke matcher mellem butikkerne**\
   Metafeltet i din kildebutik og din destinationsbutik skal have **samme datatype og struktur**.\
   Typiske uoverensstemmelser er:

* Det ene metafelt er **Tekst på én linje**, mens det andet er **Tekst med flere linjer**.
* Det ene metafelt bruger **Enkelt værdi**, mens det andet bruger **Liste over værdier**.

For at løse problemerne skal du bekræfte, at metafelterne i begge butikker har samme **namespace**, **nøgle** og **datatype**, og derefter prøve at synkronisere igen.

***

**🙋 Brug for mere hjælp?**

Hvis du stadig har brug for hjælp, er du velkommen til at kontakte os på <hi@tipo.io>. Vi hjælper dig gerne videre.
