Advanced Custom Fields (ACF): installeren, instellen en problemen oplossen

Laatst bijgewerkt: 21 oktober 2026

Advanced Custom Fields, kortweg ACF, voegt eigen velden toe aan pagina’s, berichten, producten, gebruikers en instellingen. Denk aan een veld voor een prijs, een openingstijd of een extra afbeelding. Je thema toont die velden vervolgens op de juiste plek. ACF is daardoor vaak diep met het thema verweven: werkt ACF niet, dan mist een site soms grote delen van zijn inhoud. Hieronder lees je hoe ACF werkt en hoe je de bekendste problemen oplost.

Wat doet ACF?

In ACF maak je veldgroepen met velden zoals tekst, getal, afbeelding, keuzelijst, link of relatie. Met locatieregels bepaal je waar een veldgroep verschijnt, bijvoorbeeld alleen bij het berichttype “Project” of bij één paginasjabloon. Het thema leest de waarden uit met functies zoals get_field() en the_field().

ACF PRO is de betaalde versie met onder meer het Repeater-veld, Flexible Content, Gallery, Clone, optiepagina’s en ACF Blocks voor de blokeditor. Sinds oktober 2024 staat in de officiële WordPress-bibliotheek onder de oude plek een afgesplitste versie onder de naam Secure Custom Fields; de versie van de oorspronkelijke maker download je via de eigen site van ACF. Controleer dus welke versie je site gebruikt voordat je bijwerkt.

Installeren

1. Installeer de gratis versie of upload het zip-bestand van ACF PRO via Plugins → Nieuwe plugin → Plugin uploaden. Activeer de licentie van PRO onder ACF → Updates om updates te krijgen.
2. Maak onder ACF → Veldgroepen een veldgroep, voeg velden toe en stel de locatieregels in.
3. Laat je thema of child-thema de velden tonen, of gebruik een paginabouwer die ACF-velden als dynamische inhoud kan tonen.

Instellingen die ertoe doen

• Veldnamen: de naam (sleutel) van een veld wordt in de code gebruikt. Wijzig hem niet achteraf, anders vindt je thema de bestaande waarden niet meer.
• Local JSON: met een map acf-json in je thema slaat ACF veldgroepen als bestanden op. Zo kun je ze met je thema meenemen naar een andere omgeving en in versiebeheer zetten.
• Berichttypen en taxonomieën: nieuwere versies van ACF kunnen ook eigen berichttypen en taxonomieën aanmaken, zonder extra plugin.
• Retourformaat: bij afbeeldingen en relaties kies je of je een ID, een URL of een object terugkrijgt. Je thema moet hetzelfde verwachten.

Veelvoorkomende problemen en oplossingen

“Call to undefined function get_field()” en een kritieke fout. ACF is uitgeschakeld of verwijderd, maar het thema roept de functies nog aan. Zet ACF weer aan (via de map in wp-content/plugins als je niet kunt inloggen) of laat het thema controleren of ACF bestaat. Zie kritieke fout in WordPress oplossen.

De velden verschijnen niet bij het bewerken. De locatieregels kloppen niet, de veldgroep staat op inactief, of je kijkt naar een ander berichttype of sjabloon. Controleer de regels; bij de blokeditor helpt het om het scherm opnieuw te laden.

De velden zijn ingevuld maar niet zichtbaar op de site. Het thema toont ze niet op die plek, de veldnaam in de code klopt niet, of het retourformaat wijkt af. Controleer de template en de veldnaam.

Melding over ACF en ACF PRO tegelijk. De gratis versie en PRO horen niet samen actief te zijn. Houd PRO aan als je de PRO-velden gebruikt en verwijder de gratis versie.

Melding over HTML die is weggehaald. Nieuwere versies van ACF ontsnappen onveilige HTML wanneer een veld met the_field() of de ACF-shortcode wordt getoond. Toont een veld bewust HTML of scripts, dan moet het thema dat veilig anders afhandelen.

Conflicten met andere plugins

• Andere veldplugins die dezelfde veldnamen gebruiken: kies één systeem.
• Meertaligheidsplugins zoals WPML of Polylang: stel in of velden worden vertaald, gekopieerd of gesynchroniseerd.
• Paginabouwers zoals Elementor: dynamische ACF-velden vragen daar meestal de betaalde versie van de bouwer.

Veilig bijwerken

Maak een back-up en werk ACF bij op een testkopie als je thema er sterk op leunt. Controleer daarna de belangrijkste pagina’s en de bewerkschermen. Kies bij een overstap tussen ACF en Secure Custom Fields bewust welke versie je houdt, en voorkom dat beide tegelijk actief zijn.

Wanneer schakel je hulp in?

Mist je site inhoud na een update, geeft hij een kritieke fout door get_field(), of wil je velden en sjablonen laten bouwen of aanpassen? Dan helpen wij met instellen, bijwerken en het thema. Een licentie kun je bij de maker kopen of via ons laten leveren; zie het blok “Licentie nodig?” op deze pagina. Zie ook WordPress-thema aanpassen.

Lees ook: alle WordPress-plugins · WordPress-thema aanpassen · kritieke fout in WordPress · Elementor · WPML · debug.log aanzetten

← Terug naar alle WordPress-plugins