Skip to main content
This guide covers upgrading to Advanced Tables v5. You’ll update your Composer dependency, integrate the new CSS files, run migrations, and recompile your theme. Review the important changes section at the end for any breaking changes that may affect your application.

​
Upgrade Steps

Before upgrading, first be sure you are familiar with Filament’s upgrade guide and know what changes will be needed along the way.
  1. Update the dependency Before running Filament’s upgrade script, you’ll want to update your composer.json file: 
    "archilex/filament-filter-sets": "^5.0",
    Then proceed with running Filament’s upgrade script.
    Note: If you are upgrading from Filament v4 then you may stop here. However, if you are updating from Filament v3 directly to v5, then you should continue with the steps below. You should also be familiar with Filament’s v4 upgrade guide.
  2. Integrate Filter Set’s Tailwind and css files Follow Filament’s instructions to upgrade your custom theme and add Advanced Tables’ css to your theme: 
    @import '../../../../vendor/filament/filament/resources/css/theme.css';
@import '../../../../vendor/archilex/filament-filter-sets/resources/css/plugin.css'; // Add

@source '../../../../app/Filament';
@source '../../../../resources/views/filament';
@source '../../../../vendor/archilex/filament-filter-sets'; // Add
  3. Publish and run the migrations Filament v4 has significant changes to the table columns structure to support reorderable columns and your current user views need to be upgraded to support the new structure. Publish and run the migration to update your user views to support this new structure.
    IMPORTANT: Backup your user views database table called filament_filter_set BEFORE proceeding. 
    php artisan vendor:publish --tag="advanced-tables-migrations"
php artisan migrate
  4. Compile Next, compile your theme: 
    npm run build
    and run the Filament upgrade command: 
    php artisan filament:upgrade

​
Important Changes

Listed below are changes that have occurred in v4 that may require attention by the developer.

​
Advanced Indicators

Advanced Indicators has been renamed to Quick Filters. If you are using this feature from v3, you will need to update your plugin config from advancedIndicatorsEnabled() to quickFiltersEnabled().

​
Default View

In v3, the default view was an html button that was added to the front of the favorites bar. In v4 this has been replaced with a default Preset View. This allows the default view to appear in the View Manager and, if enabled, allows the user to select a different default view. If you have a Preset View with the key default and also want to display the internal default view, then you will need to rename your default key to something different as your preset view will override the internal default view. If, per previous recommendations for Managed Default Views, you had disabled the default view and created a Preset View with the key default, this is no longer needed. You can re-enable default views, and remove the default Preset View you created. You can customize the default view using the existing internal methods

​
Reorderable Columns

To support the broader community, I’ve ported Advanced Table’s reorderable columns feature to Filament! You can enable reorderable columns by adding ->reorderableColumns() to your table: 
    return $table
        ->reorderableColumns()