Begin met de impact, niet met de installatiedatum
De belangrijkste vraag bij een Umbraco upgrade is niet wanneer je de nieuwe versie kunt installeren. Eerst moet duidelijk zijn wat de upgrade betekent voor jouw website en organisatie. Een eenvoudige website met weinig maatwerk vraagt een andere voorbereiding dan een platform met meerdere omgevingen, koppelingen, custom packages en een groot redactieteam.
Breng daarom eerst de uitgangssituatie in kaart. Noteer welke Umbraco versie je gebruikt, welke .NET-versie daarbij hoort, welke packages actief zijn en welke onderdelen speciaal voor jouw organisatie zijn ontwikkeld. Kijk ook naar formulieren, zoekfuncties, personalisatie, meertaligheid, externe koppelingen en geplande content. Zo ontstaat een eerste beeld van de technische en organisatorische impact.
Een upgrade is bovendien een goed moment om kritisch te kijken naar de rol van je website. Wil je alleen ondersteund blijven, of wil je tegelijk de beheerbaarheid, performance of functionaliteit verbeteren? Wie eerst de doelen bepaalt, voorkomt dat technische keuzes los komen te staan van wat de organisatie nodig heeft.
Welke onderdelen moet je vooraf controleren?
Een upgrade raakt niet alleen de code. Ook de content, integraties en werkwijze van redacteuren kunnen gevolgen ondervinden. Begin daarom met een inventarisatie die zowel techniek als dagelijks gebruik meeneemt.
Controleer minimaal de volgende onderdelen:
- de huidige Umbraco versie en ondersteuningsstatus;
- maatwerk in templates, compositie, controllers en frontendcode;
- packages, extensies en eigen modules die van een specifieke versie afhankelijk zijn;
- koppelingen met bijvoorbeeld CRM, ERP, marketing automation, zoekdiensten of authenticatie;
- formulieren, media, redirects, zoekfunctionaliteit en geplande publicaties;
- de ontwikkel-, test-, acceptatie- en productieomgeving;
- de rechten, rollen en werkzaamheden van redacteuren.
Documenteer per onderdeel wat je weet en waar onzekerheid zit. Vooral onbekend maatwerk en verouderde packages maken een planning kwetsbaar. Als de oorspronkelijke documentatie ontbreekt, is technisch onderzoek nodig voordat je betrouwbare keuzes kunt maken. Op de pagina over hosting en support lees je meer over continuïteit en ondersteuning rond een website.

Maak van de upgrade een onderzoek met duidelijke beslismomenten
Na de inventarisatie volgt een technische analyse. Daarin bepaal je welke onderdelen direct aangepast moeten worden, welke onderdelen kunnen blijven werken en waar alternatieven nodig zijn. Een upgrade kan bijvoorbeeld gevolgen hebben voor custom code, packages of integraties die niet automatisch meegaan naar de nieuwe versie.
Plan vervolgens een aparte testfase. Test niet alleen of de website technisch laadt, maar ook of redacteuren hun werk kunnen doen en bezoekers de belangrijkste taken kunnen uitvoeren. Denk aan content publiceren, formulieren versturen, zoeken, inloggen, betalen wanneer dat relevant is en informatie ophalen uit gekoppelde systemen.
Werk met een overzicht van bevindingen en koppel aan ieder punt een eigenaar. Noteer ook welke keuzes nog openstaan. Daarmee ontstaat een besluitdocument waarmee management, IT, marketing en de Umbraco-partner hetzelfde beeld hebben van scope, risico en afhankelijkheden.
Een upgrade kan daarnaast aanleiding zijn om verouderd maatwerk te vervangen. Dat hoeft niet automatisch onderdeel van dezelfde release te worden. Soms is het verstandiger om eerst veilig te upgraden en daarna gericht door te ontwikkelen. In andere situaties voorkomt combineren juist dubbel werk. Die keuze hangt af van de staat van het platform en de doelen van de organisatie.


Plan risicos en terugval voordat je begint
Geen enkele upgrade is zonder risico. Het risico wordt wel kleiner wanneer je vooraf bepaalt hoe je test, wie besluiten neemt en wat je doet als een onderdeel niet goed werkt. Maak daarom afspraken over een terugvalscenario. Bepaal welke back-ups nodig zijn, wanneer je een release terugdraait en wie tijdens de livegang bereikbaar is.
Let ook op de content die tijdens het traject wordt aangepast. Wanneer ontwikkelaars, redacteuren en marketeers tegelijk in verschillende omgevingen werken, moet duidelijk zijn welke wijzigingen waar thuishoren. Een gecontroleerde deployment voorkomt dat content of configuratie onbedoeld wordt overschreven.
Communicatie hoort bij de planning. Informeer redacteuren op tijd over een eventuele wijziging in de backoffice, geplande onderhoudsmomenten en nieuwe werkwijzen. Plan na de livegang een controleperiode waarin je fouten verzamelt, prioriteert en oplost. Zo wordt support geen losse reactie op incidenten, maar een gepland onderdeel van de upgrade.
Heb je nog geen vaste partner voor je Umbraco website, dan is een upgrade ook een geschikt moment om de samenwerking te beoordelen. Kijk niet alleen naar ontwikkelcapaciteit, maar ook naar kennis van jouw platform, overdraagbaarheid, documentatie en de manier waarop de partner risicos bespreekt. Meer over die keuze lees je in hoe je een Umbraco Gold Partner kiest.
Een realistische upgradeplanning in vijf stappen
Een bruikbare planning begint met de huidige situatie en eindigt niet op de dag dat de nieuwe versie live staat. Gebruik de volgende volgorde als basis en pas de duur en diepgang aan op de complexiteit van jouw platform.
- Inventariseer. Breng versie, maatwerk, packages, koppelingen, omgevingen en contentprocessen in kaart.
- Onderzoek. Controleer compatibiliteit, technische afhankelijkheden, beveiliging en bekende knelpunten.
- Bepaal de scope. Maak onderscheid tussen noodzakelijke upgradewerkzaamheden, verbeteringen en wensen voor later.
- Test en bereid voor. Richt een veilige testomgeving in, werk scenarios uit en betrek redacteuren en andere gebruikers.
- Livegang en nazorg. Plan communicatie, monitoring, een terugvaloptie en een periode voor het oplossen van bevindingen.
De planning wordt betrouwbaarder wanneer je afhankelijkheden zichtbaar maakt. Een package die eerst vervangen moet worden, kan invloed hebben op templates. Een koppeling die opnieuw getest moet worden, kan invloed hebben op de livegang. Door zulke verbanden vroeg vast te leggen, voorkom je dat een klein technisch punt pas aan het einde een groot planningsprobleem wordt.
Wanneer schakel je een Umbraco-partner in?
Zelf onderzoek doen kan een goede eerste stap zijn, zeker wanneer je documentatie op orde is en je team de techniek goed kent. Toch vraagt een upgrade vaak om kennis van versieverschillen, packages, deployment, testscenarios en de gevolgen van maatwerk. Een externe specialist kan helpen om onbekende risicos eerder zichtbaar te maken en keuzes onderbouwd vast te leggen.
ipsis helpt organisaties met het bouwen, onderhouden, overnemen en doorontwikkelen van Umbraco-websites. Als Umbraco Gold Partner combineren we technische kennis met aandacht voor beheerbaarheid en het doel van de website. Dat betekent niet dat iedere upgrade hetzelfde traject wordt. We kijken eerst naar de huidige situatie, de gewenste uitkomst en wat jouw organisatie zelf kan oppakken.
Bij een bestaande website kan de eerste stap een technische verkenning zijn. Daaruit volgt een beeld van de upgradebaarheid, noodzakelijke werkzaamheden en keuzes die je voor de planning moet maken. Heb je nog geen Umbraco website, maar onderzoek je welke oplossing past, lees dan ook meer over een maatwerk website, Umbraco of Webflow.