Skip to content
Version 5.x
Theme

Upgrade guide

View as Markdown

On this page

#New requirements

  • PHP 8.2+
  • Laravel v11.28+
  • Livewire v4.0+
  • Tailwind CSS v4.1+ when compiling custom theme or standalone CSS. Panels using Filament's precompiled CSS do not require a local Tailwind CSS compiler.

#Running the automated upgrade script

The first step to upgrade your Filament app is to run the automated upgrade script. This script will automatically upgrade your application to the latest version of Filament and make changes to your code, which handles breaking changes:

composer require filament/upgrade:"^5.0" -W --dev

vendor/bin/filament-v5

# Run the commands output by the upgrade script, they are unique to your app
composer require filament/filament:"^5.0" -W --no-update
composer update

Make sure to carefully follow the instructions, and review the changes made by the script. You may need to make some manual changes to your code afterwards, but the script should handle most of the repetitive work for you.

You can now composer remove filament/upgrade --dev as you don't need it anymore.

#Upgrading Livewire

Filament v5 requires Livewire v4.0+. You can upgrade your Livewire code by following the Livewire upgrade guide.

Documentation menu Star on GitHub