WPML-menuvertaling werkt niet? Zo synchroniseer, herstel en repareer je je menu
Je pagina’s zijn misschien perfect vertaald, maar zodra een bezoeker van taal wisselt, vertelt de navigatie een ander verhaal: ontbrekende menu-items, labels die nog in de oorspronkelijke taal staan, links naar de verkeerde pagina of een volledig menu in de standaardtaal dat opduikt waar het niet hoort. Als WPML-menuvertaling niet werkt, kan een verder verzorgde meertalige site onafgewerkt of zelfs kapot aanvoelen.
Het frustrerende is dat de vertaalde pagina vaak niet de echte boosdoener is. Voor WPML-menu’s moeten verschillende onderdelen goed op elkaar aansluiten: vertaalde items, de juiste taalinstellingen, menusynchronisatie en de themalocatie die wordt gebruikt om elk menu weer te geven. Eén enkele mismatch kan ervoor zorgen dat bezoekers de verkeerde versie van je site te zien krijgen, zelfs als elk bericht en elke pagina er in de editor goed uitziet.
Voordat je vertalingen helemaal opnieuw opbouwt, is het de moeite waard om na te gaan waar die koppeling misgaat. De oplossing is mogelijk veel eenvoudiger en minder ingrijpend dan je in eerste instantie denkt.
Waarom werkt de WPML-menuvertaling niet?
Een menu kan er vertaald uitzien en bezoekers toch naar de verkeerde pagina’s sturen. Dat maakt het diagnosticeren van een probleem met WPML-menuvertaling zo frustrerend: de zichtbare labels zijn maar één onderdeel. WPML heeft ook overeenkomende vertaalde inhoud nodig, de juiste taalinstelling en een thema dat daadwerkelijk het menu weergeeft dat je hebt aangepast.

Controleer of de vertaalde pagina’s en categorieën bestaan
WPML kan alleen een correcte menulink maken als de doelpagina in de geselecteerde taal bestaat. Als het Engelse menu naar een pagina Over ons linkt, moet die pagina ook in het Frans vertaald zijn en correct gekoppeld zijn aan het Engelse origineel. Hetzelfde geldt voor berichten, WooCommerce-producten, productcategorieën, aangepaste berichttypen en taxonomiearchieven.
Ontbrekende vertalingen leiden vaak tot onvolledige menu’s, links in de standaardtaal of items die na het synchroniseren verdwijnen. Open de vertaalde pagina of categorie en controleer de vertaalstatus voordat je iets opnieuw opbouwt. Een vertaald menu-item kan een onvertaalde bestemming niet oplossen.
Controleer of het menu aan de juiste taal is toegewezen
WPML behandelt het menu van elke taal als een apart menu. Het komt vaak voor dat de menulabels zijn vertaald, maar het menu nog aan de standaardtaal is toegewezen, of dat het vertaalde menu helemaal geen taal toegewezen heeft gekregen. In dat geval kunnen bezoekers op Franse of Duitse pagina’s nog steeds de Engelse navigatie zien.
Controleer in de WordPress-menu-editor de taal van het menu en de relatie met de vertaling ervan. Controleer vervolgens of het vertaalde menu aan de juiste themalocatie is toegewezen, zoals Primaire navigatie of Header Menu. Een perfect vertaald menu is nutteloos als de site het niet weergeeft.
Sluit themalocaties, cache en aangepaste menu-code uit
Niet elke header gebruikt de standaard WordPress-menulocatie. Sommige thema’s tonen een navigatieblok, een header van een paginabuilder of een menu dat in de eigen instellingen is geselecteerd. Aangepaste code kan ook een specifiek menu op naam aanroepen en zo de taalgevoelige afhandeling van themalocaties door WPML omzeilen.
Wis tot slot de paginacache, objectcache, CDN-cache en browsercache. Als de wijzigingen in het dashboard zichtbaar zijn, maar niet op de voorkant van de site, is caching waarschijnlijk de boosdoener. Test in een privévenster voordat je ervan uitgaat dat de menusynchronisatie is mislukt.
Een vertaald menu synchroniseren in WPML
Een menu kan vertaald lijken en bezoekers toch naar pagina’s in de verkeerde taal sturen. Daarom is WPML-menuvertaling werkt niet vaak een synchronisatieprobleem en geen vertaalprobleem. De tool Menu Sync van WPML vergelijkt de oorspronkelijke navigatie met de vertaalde versie en stelt ontbrekende koppelingen voor.
Open het scherm voor menusynchronisatie van WPML
Ga in het WordPress-dashboard naar WPML > WP Menus Sync. WPML gebruikt het menu in de standaardtaal van de site als bron en vergelijkt dit vervolgens met het bijbehorende menu in elke secundaire taal. Kies de doeltaal die je wilt herstellen en controleer of je het juiste menu synchroniseert, vooral op sites met aparte menu’s voor de header, footer, mobiele weergave en het account.
Controleer welke wijzigingen WPML wil doorvoeren
Behandel de voorgestelde wijzigingen niet als iets waarop je gedachteloos kunt klikken. WPML kan verschillende acties voorstellen:
- Nieuw vertaalde pagina’s toevoegen die in het oorspronkelijke menu staan
- Items verwijderen die niet langer in de bronavigatie staan
- Menu-items bijwerken zodat ze verwijzen naar de juiste vertaalde pagina, categorie of aangepaste berichttype
- De volgorde en hiërarchie van menu-items uit het bronmenu overnemen
Controleer elk voorstel aan de hand van de navigatie die je wilt. Een vertaald menu kan bewust afwijken. Een Engelstalige supportpagina hoeft bijvoorbeeld niet aan elke taal te worden toegevoegd. Let extra goed op aangepaste links, want WPML kan die niet altijd automatisch lokaliseren.
Pas de synchronisatie toe en controleer de links op de voorkant van de site
Selecteer de gewenste wijzigingen en pas de synchronisatie toe. Wis daarna alle paginacaches, objectcaches, CDN-caches en browsercaches; verouderde menu’s in de cache kunnen een geslaagde reparatie laten lijken op een mislukking. Wissel tot slot op de live site van taal en test alle belangrijke links: de homepage, belangrijke landingspagina’s, productcategorieën, de afreken- of contactpagina en items in uitklapmenu’s. Elke link moet naar de bijbehorende vertaling leiden en niet terugvallen op de URL in de standaardtaal.
Een WPML-menu opnieuw opbouwen als synchroniseren niet helpt
Een menu kan er in het WordPress-dashboard perfect vertaald uitzien en op de live site toch de verkeerde links tonen. Blijft de WPML-menuvertaling niet werken na synchronisatie, stop dan met synchroniseren: zo kan een kapotte koppeling telkens opnieuw worden aangemaakt. Het opnieuw opbouwen van het menu voor de betreffende taal is een veiligere oplossing, zolang je eerst de oorspronkelijke navigatie veiligstelt.
Maak een back-up van de site en leg het oorspronkelijke menu vast
Maak een volledige back-up voordat je een menu verwijdert, loskoppelt of opnieuw aanmaakt. Open daarna het werkende menu in de brontaal en leg de structuur vast. Een snelle schermafbeelding is handig, maar noteer ook details die daarop niet altijd zichtbaar zijn: menulabels, de hiërarchie van hoofd- en subitems, aangepaste URL’s, CSS-klassen, linkdoelen, beschrijvingen en speciale items zoals inloggen, winkelwagen of ankerlinks.
Noteer ook elke weergavelocatie die het menu gebruikt, waaronder Primary, Header, Footer en Mobile Menu. Veel thema’s hebben aparte locaties. Als het menu niet aan de mobiele locatie is toegewezen, kan het lijken alsof de reparatie niet is gelukt.
Maak het menu in de doeltaal aan of bouw het opnieuw op
Schakel in de WordPress-beheeromgeving over naar de doeltaal en maak vervolgens een nieuw menu aan of bouw het beschadigde menu opnieuw op via Weergave > Menu’s. Voeg de vertaalde versies van pagina’s, berichten, categorieën en producten toe in plaats van terug te linken naar inhoud in de brontaal.
Vertaal aangepaste menulabels handmatig. WPML kan niet afleiden dat “Book a Demo” beter kan worden omgezet in een gelokaliseerde marketingtekst dan in een letterlijke vertaling. Bouw de oorspronkelijke hiërarchie precies na: sleep subitems onder het juiste hoofditem, want een item op het verkeerde niveau kan een uitklapmenu veranderen in een link die lijkt te ontbreken.
Wijs het vertaalde menu toe aan de juiste weergavelocatie
Het menu aanmaken is maar de helft van de oplossing. Wijs het menu voor de doeltaal toe aan dezelfde themalocatie als het origineel, bijvoorbeeld Primary of Header, terwijl de doeltaal actief is. Controleer de site in een incognitovenster en test zowel de desktop- als de mobiele navigatie. Als het juiste menu bestaat maar niet is toegewezen, kan WordPress terugvallen op een ander menu. Daardoor lijkt het probleem een vertaalfout van WPML, terwijl het in werkelijkheid om een locatie-instelling gaat.
Specifieke problemen met WPML-menuvertalingen oplossen
Menu-items ontbreken na het vertalen
Een menu kan perfect gesynchroniseerd lijken en toch belangrijke links missen. Meestal ligt dat niet aan het menu zelf: WPML toont geen gekoppelde pagina in de doeltaal als die pagina niet vertaald is, de vertaling nog een concept is of het betreffende berichttype is uitgesloten van vertaling. Controleer eerst de vertaalstatus van elke ontbrekende bestemming. Voer daarna Menu Sync opnieuw uit, vooral nadat je nieuwe pagina’s hebt toegevoegd. Bestaande vertaalde menu’s krijgen niet automatisch elk nieuw navigatie-item.
Menulabels staan nog in de oorspronkelijke taal
Niet elk zichtbaar label komt uit dezelfde bron. Een menu-item dat naar een vertaalde pagina linkt, kan de vertaalde paginatitel overnemen. Maar een aangepast navigatielabel, zoals “Contact” veranderen in “Neem contact op”, is aparte menutekst en moet mogelijk in het vertaalde menu worden aangepast. Aangepaste links staan daar weer los van: vertaal zowel het label als, waar nodig, de bestemmings-URL. Zoek bij labels die door het thema worden gegenereerd naar de oplossing in WPML String Translation, in plaats van het menu steeds opnieuw op te bouwen.
Na het wisselen van taal verschijnt het verkeerde menu
Als WPML-menuvertaling niet werkt betekent dat het verkeerde menu in zijn geheel verschijnt, controleer dan eerst de menulocaties. Elk taalspecifiek menu moet aan dezelfde themalocatie zijn toegewezen, zoals Primary of Footer. Headerbuilders kunnen hun eigen menuselecties gebruiken, dus controleer ook de instellingen van Elementor, Bricks of de header van je thema. Wis tot slot de paginacaches, objectcaches, CDN-caches en browsercaches. Als aangepaste code een menu met een vast ID of een vaste naam aanroept, kan die de taalgevoelige afhandeling van WPML omzeilen.
Voorkom dat menu-updates in de toekomst niet meer synchroon lopen
Vertaal gekoppelde inhoud eerst en gebruik Menu Sync na elke structurele wijziging: nieuwe pagina’s, gewijzigde volgorde, andere hoofditems of verwijderde links. Test zowel de desktop- als de mobiele navigatie, omdat veel thema’s aparte menulocaties gebruiken. Houd een korte lijst bij van vertaalde aangepaste links en handmatig aangepaste labels; juist die worden later het vaakst over het hoofd gezien.
Sites die WPML al gebruiken, kunnen ook LATW AI Translator for WPML gebruiken om in aanmerking komende pagina- en berichtinhoud via de WPML-workflow te vertalen met hun eigen API-sleutel. Het is een add-on waarvoor WPML vereist is; de add-on vervangt de menu-infrastructuur of het menusynchronisatieproces van WPML niet.
Herstel je navigatie
Als WPML-menuvertaling niet werkt, doorloop dan de herstelstappen in de juiste volgorde: controleer of de gekoppelde pagina’s vertalingen hebben en aan de juiste taal zijn toegewezen, voer WPML Menu Sync uit, bouw het menu voor de doeltaal opnieuw op als synchronisatie de structuur niet kan herstellen en wijs dat menu vervolgens toe aan de juiste themalocatie. Wis alle relevante caches — die van WordPress, plugins, server, CDN en browser — voordat je het resultaat beoordeelt.
Gedraagt het menu zich na die controles nog steeds anders, kijk dan verder dan WPML zelf. Veel hardnekkige problemen komen voort uit de aangepaste headerbuilder van een thema, een mobiele menu-implementatie of maatwerkcode voor de navigatie die de standaard WordPress-menulocatie niet gebruikt. Een vertaald menu kan alleen worden weergegeven als het thema klaarstaat om het te laden. Zodra de navigatielaag correct is gekoppeld, kan elke taal bezoekers precies naar de juiste plek leiden.