tomatophp/filament-language-switcher

Filament Language Switcher

Switch between languages on your app using user base column on database

⭐ If this package saves you time, star it and browse 60+ more Filament plugins at tomatophp.com/en/plugins.

Version Compatibility

Screenshots

Installation

composer require tomatophp/filament-language-switcher

after install your package please run this command

php artisan filament-language-switcher:install

finally register the plugin on /app/Providers/Filament/AdminPanelProvider.php

->plugin(\TomatoPHP\FilamentLanguageSwitcher\FilamentLanguageSwitcherPlugin::make())

now on your User.php model or any user model add this trait

use \TomatoPHP\FilamentLanguageSwitcher\Traits\InteractsWithLanguages;

now you must see the switcher and you can change language as you like

If your user table has a lang column it is used, otherwise the language is stored in the user_languages table. Users who never picked a language get app.locale.

Languages

The languages shown in the switcher come from the locals key of the config file. Each language needs a label and a flag (a country code from country-flags):

'locals' => [
    'en' => ['label' => 'English', 'flag' => 'gb'],
    'nl' => ['label' => 'Dutch', 'flag' => 'nl'],
],

The package names every default language in 18 languages; a language without a translated name shows its label. Set show_flags to false to hide the flags in the list.

Security

The switch route (/languages/switcher?lang=xx) only changes the language of the signed in user. Guests get a 403 and languages that are not in locals are rejected. The model and model_id parameters sent by older versions are ignored.

Publish Assets

you can publish config file by use this command

php artisan vendor:publish --tag="filament-language-switcher-config"

you can publish views file by use this command

php artisan vendor:publish --tag="filament-language-switcher-views"

you can publish languages file by use this command

php artisan vendor:publish --tag="filament-language-switcher-lang"

you can publish migrations file by use this command

php artisan vendor:publish --tag="filament-language-switcher-migrations"

Testing

if you like to run PEST testing just use this command

composer test

Code Style

if you like to fix the code style just use this command

composer format

PHPStan

if you like to check the code by PHPStan just use this command

composer analyse

Other Filament Packages

Checkout our Awesome TomatoPHP

More open source from the same author

• TomatoPHP: 60+ open-source FilamentPHP plugins for Laravel
• Laravilt: Laravel admin panels rendered with Inertia on Vue 3 or React 19
• ToGO: the Laravel-style workflow for Go + React apps, with a plugin marketplace
• Zekra: long-term memory for AI agents over MCP

Built by Fady Mondy.