Een migratie van Umbraco naar WordPress klinkt misschien als een grote stap, maar met de juiste voorbereiding is het een overzichtelijk proces. Of je nu overstapt omdat Umbraco 8 zijn end of life heeft bereikt en geen beveiligingsupdates meer ontvangt, of omdat je simpelweg een platform wil dat makkelijker te beheren is: WordPress biedt een enorm ecosysteem, een intuïtieve redactieomgeving en een actieve community die je daarna ondersteunt.
In deze handleiding doorloop je de migratie stap voor stap, van voorbereiding tot livegang. Na het lezen weet je precies wat je nodig hebt, hoe je content exporteert en importeert, en hoe je voorkomt dat je SEO-rankings verloren gaan tijdens de overgang.
Wat je nodig hebt vóór de migratie
Goede voorbereiding is het halve werk. Voordat je ook maar één bestand verplaatst, zorg je dat je de juiste tools en informatie bij de hand hebt. Een migratie zonder voorbereiding is als verhuizen zonder dozen: alles komt op één hoop terecht.
Controleer eerst of je hostingomgeving klaar is voor WordPress. De technische minimumvereisten zijn:
- PHP-versie: minimaal PHP 7.4, maar PHP 8.2 of 8.3 wordt aanbevolen voor de beste combinatie van snelheid en veiligheid
- Schijfruimte: minimaal 1 GB, maar kies bij voorkeur een pakket met 10 GB of meer
- RAM: minimaal 512 MB
- SSL-certificaat: verplicht voor HTTPS-ondersteuning
Naast de technische checklist maak je ook een informatieve voorbereiding:
- Back-up van je huidige site: exporteer database, bestanden en afbeeldingen volledig
- URL-inventaris: gebruik een tool zoals Screaming Frog om alle bestaande URL’s te crawlen en te exporteren
- Rankings uit Google Search Console: sla je huidige rankingdata op als nulmeting, zodat je na de migratie kunt vergelijken
Heb je dit allemaal klaarstaan? Dan ben je klaar voor de volgende stap.
Breng je Umbraco-content in kaart
Voordat je begint met exporteren, breng je de structuur van je Umbraco-site volledig in kaart. Umbraco werkt met Document Types, Media Types en Data Types die in WordPress anders worden georganiseerd. Zonder overzicht weet je niet wat je meeneemt en wat je achterlaat.
Voer een contentaudit uit. In de praktijk blijkt dat de meeste content geclusterd zit in slechts een paar contenttypes, zoals nieuwsartikelen of productpagina’s. Dat maakt de mapping overzichtelijker dan je misschien verwacht. Een migratie is ook meteen een opschoningsmoment: oude complexiteit die gebaseerd was op aannames van jaren geleden hoeft niet mee.
Let bij je audit op de volgende onderdelen:
- Contenttypes en taxonomieën: welke Document Types bestaan er en hoeveel content valt onder elk type?
- Mediabibliotheek: zijn bestanden dubbel opgeslagen of onlogisch geordend? Controleer ook of verwijzingen tussen content en media nog kloppen
- Integraties en koppelingen: welke externe systemen zijn gekoppeld aan je Umbraco-site?
- SEO-staat: noteer verkeer, rankings en backlinks per pagina
- Redactieworkflows: zijn er specifieke workflows of gebruikersrollen die je wil behouden?
Leg alles vast in een spreadsheet. Dat document wordt je leidraad voor de rest van de migratie.
Exporteer content uit Umbraco
Er bestaat geen directe plugin die content rechtstreeks van Umbraco naar WordPress overzet. Je werkt altijd via een tussenstap: een exportformaat zoals XML, CSV of JSON. Dit klinkt technischer dan het is.
Exporteren vanuit Umbraco 8 en hoger
Gebruik de ingebouwde import- en exportfunctie van Umbraco Deploy Deze link opent in een nieuw tabblad. Via de backoffice exporteer je content en schema naar een ZIP-bestand. Dat bestand gebruik je later als basis voor de import in WordPress.
- Log in op de Umbraco-backoffice
- Navigeer naar de Deploy-sectie en kies voor exporteren
- Selecteer de contenttypes en pagina’s die je wil meenemen
- Download het gegenereerde ZIP-bestand en sla het op een veilige locatie op
Exporteren vanuit Umbraco 7
De standaardexportfunctie is hier niet beschikbaar vanuit de backoffice. Je hebt de aparte assembly Umbraco.Deploy.Contrib.Export nodig om een exportarchief aan te maken in hetzelfde formaat als nieuwere versies. Raadpleeg hiervoor je ontwikkelaar of een Umbraco-specialist.
Voor grotere of complexere sites is een geautomatiseerde aanpak met een connector-tool het overwegen waard. Dit bespaart tijd en vermindert de kans op fouten bij de data-overdracht. Controleer na het exporteren of je bestand alle verwachte pagina’s, media en metadata bevat voordat je verdergaat.
Zet je WordPress-omgeving klaar
Met je geëxporteerde content klaar, richt je nu de WordPress-omgeving in. Installeer WordPress op je hosting en zorg dat de omgeving voldoet aan de technische vereisten die je in stap één hebt gecheckt. De meest recente stabiele versie is WordPress 6.8.
- Installeer WordPress via het controlepaneel van je hostingprovider of handmatig via FTP
- Activeer een SSL-certificaat op de nieuwe server
- Installeer een back-upplugin zoals UpdraftPlus, zodat je altijd een herstelpunt hebt tijdens de migratie
- Installeer en configureer een thema dat aansluit op je gewenste uitstraling, maar activeer het nog niet definitief
- Installeer WP All Import alvast, want die heb je nodig in de volgende stap
Werk je liever niet zelf met serverinstellingen en PHP-configuraties? Bij WordPress development nemen we de technische inrichting volledig uit handen, inclusief een strenge pluginselectie voor betere performance en beveiliging. Maar je kunt de migratie ook volledig zelfstandig uitvoeren met de stappen in deze handleiding.
Controleer na de installatie of WordPress correct laadt en of het SSL-certificaat actief is. Je browser toont een slotje in de adresbalk als HTTPS correct werkt.
Importeer content in WordPress
Nu komt het echte werk: je Umbraco-content importeren in WordPress. De ingebouwde WordPress-importtool werkt alleen goed voor eenvoudige blogberichten in het eigen WordPress-formaat. Voor content uit een ander CMS zoals Umbraco heb je een krachtigere tool nodig: WP All Import.
WP All Import werkt via een drag-and-drop-interface en vereist geen codering of directe databasebewerkingen. De plugin importeert XML-, CSV- en Excel-bestanden en kan ook afbeeldingen downloaden vanuit URL’s in je importbestand, wat handig is voor de mediabibliotheek.
- Ga in WordPress naar Plugins > Nieuwe plugin en installeer WP All Import
- Navigeer naar All Import > Nieuwe import en upload je geëxporteerde XML- of CSV-bestand
- Kies het importdoel: berichten, pagina’s of een aangepast posttype
- Koppel de velden uit je importbestand aan de juiste WordPress-velden via de drag-and-drop-interface
- Stel de media-import in: laat WP All Import afbeeldingen downloaden en toevoegen aan de mediabibliotheek
- Voer de import uit en wacht tot het proces is voltooid
Na de import zie je in het WordPress-dashboard hoeveel berichten en pagina’s zijn aangemaakt. Klik een aantal pagina’s door om te controleren of de content correct is overgezet en de opmaak klopt.
Controleer en herstel de gemigreerde content
Na de import is het tijd om alles grondig te controleren. Een succesvolle import betekent niet automatisch dat alles perfect werkt. Neem de tijd voor deze stap, want fouten die je nu mist, kosten je later meer tijd.
Loop de volgende punten systematisch na:
- Afbeeldingen: controleer of alle afbeeldingen correct laden. WordPress gebruikt absolute URL’s, die na een migratie soms niet meer kloppen. Controleer in de mediabibliotheek of de URL’s verwijzen naar de nieuwe domeinnaam
- Interne links: gebruik de plugin Broken Link Checker om gebroken links op te sporen en te corrigeren
- SEO-metadata: controleer titels, metabeschrijvingen en alt-teksten op volledigheid
- Canonical tags: zorg dat canonical tags correct zijn ingesteld om duplicate content te vermijden
- Functionaliteiten: test contactformulieren, aanmeldprocessen en eventuele check-outs
- Meertalige content: als je site meerdere talen ondersteunt, controleer dan elke taalversie apart
Verwijder ook eventuele noindex-instellingen die je tijdens de testfase hebt ingesteld. Controleer het robots.txt-bestand en dien een nieuwe XML-sitemap in bij Google Search Console Deze link opent in een nieuw tabblad. Pas als alles groen licht geeft, ga je live.
Stel redirects in en bescherm je SEO
Dit is de stap die het meeste verschil maakt voor je vindbaarheid na de migratie. Elke bestaande URL krijgt een 301-redirect naar zijn nieuwe bestemming. Een 301 is een permanente doorverwijzing die vrijwel alle opgebouwde SEO-waarde overdraagt aan de nieuwe pagina. Sla je deze stap over, dan kan je site maanden onzichtbaar zijn in Google.
- Gebruik je eerder gemaakte URL-inventaris als basis voor de redirect-mapping
- Installeer de gratis Redirection-plugin in WordPress
- Navigeer naar Extra > Redirection en voeg per URL een doorverwijzing toe van de oude naar de nieuwe URL
- Vergeet ook afbeeldingen en PDF’s te redirecten, niet alleen pagina’s
- Activeer de nieuwe site en ga live
Gebruik je al Yoast SEO of Rank Math? Dan kun je redirects ook direct vanuit die plugins beheren. Yoast SEO Premium heeft een ingebouwde Redirect Manager waarmee je ook verwijderde content automatisch kunt redirecten.
Houd na de livegang dagelijks Google Search Console in de gaten op crawlfouten en rankingbewegingen. Een kleine daling in bezoekersaantallen direct na de migratie is normaal: Google heeft tijd nodig om de nieuwe situatie te indexeren. Laat het oude domein actief en verleng de registratie voor minimaal twee jaar, zodat opgebouwde backlinks niet verloren gaan.
Veelvoorkomende problemen bij Umbraco-migraties oplossen
Zelfs met een goede voorbereiding kunnen er dingen misgaan. Hier zijn de meest voorkomende problemen en hoe je ze oplost.
Gebroken afbeeldingen na de migratie
Dit gebeurt bijna altijd door verkeerde URL-paden. Controleer in de WordPress-mediabibliotheek of de URL’s correct verwijzen naar de nieuwe domeinnaam. WP All Import kan helpen om afbeeldingen opnieuw te importeren als dat nodig is.
Verlies van maatwerkfunctionaliteiten
Umbraco maakt soms gebruik van specifieke .NET-functionaliteiten die niet direct vertalen naar WordPress. Inventariseer vooraf welke functies echt noodzakelijk zijn en hoe ze in WordPress kunnen worden nagebouwd. Niet alles hoeft één-op-één te worden herbouwd; een migratie is ook een kans om te vereenvoudigen.
Rommelige data na de import
Content overzetten zonder structuur leidt snel tot chaos. De oplossing zit altijd in de voorbereiding: een heldere contentaudit vooraf voorkomt dat je achteraf moet opruimen. Gebruik de contentmapping uit stap twee als leidraad.
Technische problemen door verkeerde PHP-versie
Als je site na de migratie niet correct laadt, controleer dan of de PHP-versie op de nieuwe server voldoet aan de WordPress-vereisten. PHP 8.2 of 8.3 wordt aanbevolen. Dit stel je in via het controlepaneel van je hostingprovider.
DNS te vroeg aanpassen
Pas de DNS pas aan als de nieuwe site volledig werkt op de nieuwe server. Als je de DNS aanpast terwijl de site nog niet klaar is, stuur je bezoekers naar een niet-werkende pagina. Test altijd eerst grondig via een tijdelijk testdomein of hosts-bestand.
Een goed uitgevoerde migratie van Umbraco naar WordPress hoeft geen rankings te kosten en geeft je een platform dat makkelijker te beheren is. Wil je de migratie liever overlaten aan een team dat dit vaker heeft gedaan? Neem contact op met Stuurlui voor een vrijblijvend gesprek over jouw situatie.