Met entity diversions stuur je data uit je bronplatform naar een ander Shopify-entiteit dan de standaard. Denk aan een CMS-pagina die je als blogartikel wilt migreren, of productspecificaties die je als metaobject wilt opslaan in plaats van als metaveld. Hierdoor behoud je de flexibiliteit om je data op de juiste plek in Shopify te krijgen — passend bij hoe je je webshop wilt inrichten.
Wanneer gebruik je entity diversions?
Je gebruikt entity diversions wanneer een 1-op-1 migratie niet bij je behoefte past. Veelvoorkomende toepassingen:
CMS-pagina's → blogartikelen — een nieuwsoverzicht of blog-CMS uit je bronplatform omzetten naar de Shopify blog
Blogposts → metaobjects — recepten, FAQ-items of cases als gestructureerde metaobjects opslaan
Categorieën → een statische blog — categorie-data inzetten als reguliere blogartikelen
Producten → metaobjects — productdata gebruiken voor secundaire content zoals merken of collecties
Vooraf in Shopify klaarzetten
Voor diversions naar metaobjects moet je eerst de metaobject-definitie aanmaken in Shopify zelf. Zonder definitie kan Syncer de data niet wegschrijven.
Ga in Shopify naar Settings → Custom data → Metaobjects
Maak een nieuwe definitie aan met de velden die je wilt vullen
Noteer het type-handle (bijvoorbeeld
cms_page,recipe,faq) — dit gebruik je straks in Syncer
Een diversion instellen
Stap 1 — Open Entity diversions
Ga naar Settings → Advanced → Entity diversions. Je ziet een overzicht van bestaande diversions (indien aanwezig).
Stap 2 — Maak een nieuwe diversion
Klik op Add diversion. Er opent een modal waarin je de bron en het doel kiest.
Stap 3 — Bepaal het doel (target entity)
Kies wat je wilt aanmaken in Shopify:
Metaobject — voor gestructureerde content (alleen mogelijk als de definitie bestaat in Shopify)
Article — blogartikelen
Blog — een nieuwe blog (container voor articles)
Wanneer je voor metaobject kiest, selecteer je de juiste metaobject-definitie uit de lijst, of vul je het type-handle handmatig in. Voor articles kies je de doel-blog waar de artikelen onder vallen.
Stap 4 — Bepaal de bron (source)
Selecteer welke data uit je bronplatform je wilt omzetten: CMS pages, blog posts, categories of andere beschikbare bronnen per platform.
Stap 5 — Veldmappings instellen
Per doelveld geef je aan waar de data vandaan komt:
Bronveld — kies een veld uit je bronplatform (bijvoorbeeld
title,body,created_at)Statische waarde — vul een vaste waarde in die voor alle records gelijk is
💡 De handle wordt automatisch gegenereerd vanuit title als je hier niets invult. Je kunt de handle ook handmatig overschrijven.
Stap 6 — Sla op
Klik op Save. De diversion is nu actief en wordt meegenomen bij de volgende migratierun.
Bestaande diversions beheren
In het overzicht zie je per diversion de bron en het doel (bijvoorbeeld CMS pages → Recipe metaobject) en het aantal velden dat is gemapped.
Bewerken — klik op het potloodje om mappings aan te passen
Verwijderen — klik op het prullenbakje en bevestig in de modal
⚠️ Verwijderen kan niet ongedaan worden gemaakt.
Resultaat in Shopify
Na het uitvoeren van de migratie wordt elke bronentry aangemaakt als het gekozen doeltype (metaobject, article of blog), worden velden gevuld volgens de ingestelde mappings, en is de data direct beschikbaar in Shopify voor gebruik in thema's en apps.
🔍 Werkt iets niet zoals verwacht? Controleer of de bron en het doel correct zijn ingesteld, en of de metaobject-definities in Shopify aanwezig zijn met de juiste velden.