Herroepingsknop Magento 2: zo plaats je hem
Herroepingsknop Magento 2: plaatsen kan via een CMS-blok, via layout-XML in je thema of via Google Tag Manager. Hieronder de drie routes met stappen, de CSP-instelling die je bijna altijd nodig hebt, en wat je na het plaatsen controleert.
Bijgewerkt in september 2026 · 6 minuten lezen
Wat een herroepingsknop in Magento 2 moet doen
Sinds 25 juni 2026 moet elke webshop die aan consumenten verkoopt een herroepingsknop hebben: duidelijk zichtbaar, de hele bedenktijd beschikbaar, met een kort formulier en een automatische bevestiging met datum en tijdstip. Magento 2 heeft die functie niet aan boord. Je kiest dus een van de drie routes hieronder.
Eerst dit: de Content Security Policy
Magento 2.4 heeft een Content Security Policy die scripts van externe domeinen blokkeert of rapporteert. Wil je het Retourly-script laden, dan hoort retourly.nl in de whitelist. Dat doe je met een bestand etc/csp_whitelist.xml in je thema of in een kleine module, met retourly.nl bij de policies script-src en connect-src. Zonder deze stap laadt de knop niet, of zie je meldingen in de browserconsole. Je bureau doet dit in een kwartier.
Route 1: het Retourly-script via een CMS-blok
Eén script-tag, geen extensie. Het script tekent de knop, opent het formulier, mailt de bevestiging en bewaart elke herroeping met tijdstip in je Retourly-beheer. Gratis, ook zonder abonnement.
- Maak een gratis account en kopieer het script van de pagina Herroepingsknop in je beheer.
- Ga in de Magento-admin naar Content → Blokken en maak een blok "Herroepingsknop". Gebruik in Page Builder het element HTML-code, of zet de editor op HTML-weergave, en plak het script.
- Plaats het blok in de footer: via Content → Widgets (type "CMS Static Block", container footer) of via layout-XML in je thema.
Alternatief: layout-XML in je thema
Laat je bureau in Magento_Theme/layout/default.xml een blok toevoegen in de footer-container met een template dat het script bevat. Netter dan een CMS-blok als je toch al een deploy doet, en het reist mee met je thema.
Route 2: Google Tag Manager als snelle route
Draai je al Tag Manager op je Magento-shop, dan is dit de snelste weg: maak een tag "Custom HTML" met het script, trigger All Pages, publiceren. Geen deploy, geen bureau. Let op twee dingen: Tag Manager moet zelf al in de CSP-whitelist staan, en een knop die pas na cookie-toestemming laadt is niet "altijd beschikbaar". Zet de tag dus buiten je consent-conditie; het script plaatst geen cookies.
Route 3: zelf een pagina met formulier bouwen
Magento heeft geen formulierbouwer aan boord. Het contactformulier (Contact Us) stuurt de inzending naar jou en niet naar de klant, terwijl de wet juist een bevestiging aan de klant vraagt, met inhoud en tijdstip. Zelf bouwen betekent dus een kleine module of een formulierextensie met automatisch antwoord en opslag van inzendingen.
- Maak een CMS-pagina "Bestelling herroepen" met uitleg en het formulier: naam, ordernummer, e-mailadres, de herroepingsverklaring als vaste tekst en optioneel een toelichting.
- Zorg voor een automatische bevestiging aan de klant met ordernummer en datum en tijd, en voor opslag van elke inzending.
- Zet een link "Bestelling herroepen" in de footer en op je retourpagina.
Onderhoudslast: de module of extensie moet mee met elke Magento-upgrade. Sommige RMA-extensies bieden een herroepingsfunctie; controleer dan of de bevestiging met tijdstip en de registratie kloppen. Welke extensies er zijn en wat ze kosten, staat in de gids RMA module Magento 2 kiezen. Voorbeeldteksten voor formulier en mail staan in herroepingsknop voorbeeld.
Hoeveel tijd en onderhoud kost elke route
| Route | Plaatsen | Onderhoud | Kosten |
|---|---|---|---|
| Retourly-script via CMS-blok of Tag Manager | 15 minuten plus CSP-whitelist | CSP en blok controleren bij upgrades | Gratis |
| Layout-XML in je thema | Een deploy door je bureau | Reist mee met het thema | Uren van je bureau |
| Eigen module of RMA-extensie | Dagen tot weken | Mee met elke Magento-upgrade | Licentie plus onderhoud |
Voor een shop met 25 tot 150 retouren per maand is de rekensom meestal simpel: de knop moet er staan, hij moet blijven werken, en niemand heeft tijd om er elke update naar te kijken. Kies de route die je het minste onderhoud oplevert, niet de route die het meest "eigen" voelt.
Dit test je na het plaatsen
- Geen CSP-meldingen in de browserconsole en de knop zichtbaar op elke pagina, ook op mobiel en in het klantaccount.
- Doe een testherroeping met een echt ordernummer: komt de bevestiging binnen een minuut binnen, met datum en tijd?
- Staat de herroeping ergens geregistreerd waar je hem over drie maanden terugvindt?
- Verwijst je retourbeleid naar de knop, en andersom?
- Zet "knop en CSP controleren" in je checklist bij elke Magento-upgrade.
Dit artikel is algemene informatie, geen juridisch advies. De wettelijke eisen staan in artikel 6:230oa BW.
Veelgestelde vragen
Waarom laadt het script niet in Magento 2?
Meestal door de Content Security Policy. Magento 2.4 blokkeert of rapporteert scripts van externe domeinen. Voeg retourly.nl toe aan de csp_whitelist.xml van je thema of module, of laad het script via Google Tag Manager.
Kan ik het script in een CMS-blok zetten?
Ja, in een blok van het type HTML-code (Page Builder) of in de WYSIWYG-editor met de HTML-weergave. Plaats het blok in de footer via een widget of layout-XML.
Is een RMA-extensie hetzelfde als een herroepingsknop?
Nee. Een RMA-extensie regelt retouraanvragen; de herroepingsknop is de wettelijke functie om de overeenkomst te ontbinden, met een bevestiging met tijdstip. Sommige extensies bieden beide, controleer het.
Liever dat het vanzelf loopt?
Gratis, geen extensie, geen deploy. Bevestiging met tijdstip naar klant en shop.