Filament v5 upgraden: dit moet je weten

Op 16 januari 2026 is Filament v5 officieel uitgebracht. Als je Filament gebruikt in je Laravel-projecten, vraag je je misschien af: moet ik dit nu doen? En wat verandert er eigenlijk? In deze blog delen we onze eigen ervaringen en geven we je een eerlijk beeld van wat de upgrade inhoudt.

Waarom bestaat Filament v5 eigenlijk?

Dit is misschien het meest verrassende deel: Filament v5 heeft geen nieuwe functies ten opzichte van v4. Geen nieuwe componenten, geen nieuwe API, geen grote wijzigingen in hoe je werkt.

De enige reden voor een major versie is Livewire v4. Filament is sterk afhankelijk van Livewire, en Livewire v4 brengt grote interne veranderingen met zich mee. Het Filament-team had twee opties: de Livewire-update stiekem in een minor versie stoppen, of het netjes als een nieuwe major versie uitbrengen. Ze kozen voor het tweede, en dat is de juiste keuze.

Filament v4 en v5 blijven allebei nieuwe functies ontvangen, dus er is geen tijdsdruk om te upgraden als je dat nu nog niet kunt.

Marketing

Het Filament-team is druk bezig met de tool beschikbaar maken voor een nog breder publiek. Deze week is daarom een redesign van de website uitgebracht. Neem snel een kijkje, want de illustraties zijn gewelig: https://filamentphp.com.

Wat heb je nodig vóór de upgrade?

Voordat je begint, controleer je of je project aan deze eisen voldoet:

• PHP 8.2 of hoger
• Laravel 11 of hoger
• Livewire v4 (dit is de grootste stap)
• Tailwind CSS v4 (dit verrast sommige projecten)

Dat laatste punt, Tailwind v4, is voor bestaande projecten soms een struikelblok. Heb je een eigen thema gebouwd op Tailwind v3, dan moet je dat eerst aanpakken. Pas daarna ga je verder met Filament zelf.

Waar lopen we zelf tegenaan?

Plugins die nog niet klaar zijn

Dit is veruit het meest praktische probleem. Niet alle Filament-plugins ondersteunen v5 al. Het upgrade-script detecteert dit en stopt dan met een foutmelding als “Incompatible plugins found”.

Onze aanpak: maak een overzicht van alle gebruikte Filament-plugins en controleer hun changelog of GitHub-pagina vóórdat je begint. Zo weet je of je kunt doorgaan of even moet wachten.

Windows en het upgrade-script

Het schijnt dat het script op Windows PowerShell stukloopt omdat laravel/prompts daar niet goed werkt. De oplossing zou zijn: gebruik WSL (Windows Subsystem for Linux) om het script uit te voeren. We hebben dit zelf niet getest.

Livewire-componenten controleren

Heb je eigen Livewire-componenten geschreven, dan moet je ook de Livewire-upgradehandleiding volgen. Filament regelt zijn eigen componenten, maar die van jou niet. Dit kost extra tijd bij grotere projecten.

Moet je nu upgraden?

Eerlijk antwoord: nee, niet per se. Filament v4 ontvangt nog gewoon nieuwe functies en bugfixes. Er is geen einddatum voor support bekend.

Wil je wel upgraden? Dan is dit een goed moment als:

• Je toch al van plan was Livewire of Tailwind bij te werken
• Je project relatief weinig externe plugins gebruikt
• Je in een rustiger deel van het project zit

Heb je een kritiek systeem in productie met veel externe plugins? Wacht dan totdat de meeste plugins klaar zijn voor v5. Dat is geen zwakte, dat is verstandig plannen.

Filament Blueprint: nieuw hulpmiddel voor AI-gedreven ontwikkeling

Naast v5 lanceerde het Filament-team ook Filament Blueprint. Dit is een betaald hulpmiddel zodat AI-codeerassistenten beter begrijpen hoe Filament werkt. Gebruik je tools als Claude Code of Cursor om Filament-code te schrijven, dan kan Blueprint helpen om nauwkeurigere implementatieplannen te krijgen.

We zijn zelf nog aan het bekijken of dit de moeite waard is voor onze projecten. Interessant, maar niet essentieel voor de upgrade zelf.

Onze conclusie

Filament v5 is een nette, verantwoorde upgrade. Het Filament-team heeft de juiste keuze gemaakt door dit als major versie te behandelen in plaats van stiekem Livewire v4 er doorheen te drukken. De upgrade zelf is snel als je project in orde is. De echte voorbereiding zit in het controleren van je plugins en het upgraden van Tailwind en Livewire.

Voor productieprojecten raden we aan om de upgrade goed te plannen en te testen in een stagingomgeving voordat je live gaat.

Werk je met Filament in een zakelijk project en wil je hulp bij de upgrade of bij het bouwen van een nieuw admin panel? Neem gerust contact op via onze contactpagina. We denken graag met je mee.