What's Changed

v5.0.0

Filament v5 support. The rendering internals have been rewritten — the plugin now classifies render hooks into contexts (topbar, sidebar, user-menu, outside-panel) and picks the matching trigger design automatically. Trigger styling, item display, display mode, and outside-panel placement are now controlled through dedicated enums instead of loosely typed strings and booleans. Most v4 configurations work unchanged.

Breaking changes

Renames

v4	v5
->flagsOnly()	->itemStyle(ItemStyle::FlagOnly)
Placement::TopLeft / TopRight	Placement::TopStart / TopEnd
Placement::BottomLeft / BottomRight	Placement::BottomStart / BottomEnd

Default changes

Setting	v4	v5	Restore v4
maxHeight	'max-content'	'18rem'	->maxHeight('max-content')
renderHook	global-search.after always	Context-aware	->renderHook(PanelsRenderHook::GLOBAL_SEARCH_AFTER)
outsidePanelsRenderHook	body.start always	Derived from placement + mode	->outsidePanelsRenderHook(PanelsRenderHook::BODY_START)

Everything else from v4 — visible(), locales(), flags(), labels(), renderHook(), outsidePanelPlacement(), excludes(), circular(), nativeLabel(), displayLocale(), userPreferredLocale() — keeps its v4 signature.

What's new

• Trigger customization — TriggerStyle enum via ->trigger(style:, icon:). Auto-adapts to the render context.
• Item style — ItemStyle enum (FlagWithLabel, FlagOnly, AvatarWithLabel, AvatarOnly, LabelOnly) via ->itemStyle().
• Modal display mode — ->displayMode(DisplayMode::Modal) with grid columns, slide-over, heading, icon, and width.
• Outside panels rebuilt — PlacementMode (Static, Pinned, Relative) with auto-derived render hooks and user-menu auto-docking.
• Smart hook classification — trigger design adapts automatically per render hook context.
• Dropdown placement — ->dropdownPlacement() to control dropdown direction.
• Inline Blade component — <x-language-switch::inline /> for embedding in custom views.
• Developer Control Panel — ->controlPanel() for live configuration in local dev.

See the README for full usage and examples.

• 5.x by @bezhanSalleh in #159

Full Changelog: 4.3.0...5.0.0-beta.1

What's Changed

• Bump dependabot/fetch-metadata from 2.5.0 to 3.0.0 by @dependabot[bot] in #155
• fixes stringle and outside panels route condition by @bezhanSalleh in #158

Full Changelog: 4.2.0...4.3.0

What's Changed

• Laravel 13 Support by @bezhanSalleh in #154

Full Changelog: 4.1.0...4.2.0

What's Changed

• Filament 5.x support
• Bump actions/checkout from 3 to 6 by @dependabot[bot] in #137
• Bump stefanzweifel/git-auto-commit-action from 4 to 7 by @dependabot[bot] in #134
• Fix Closure evaluation in general by @gp-lnuff in #133
• Command correction to publish views by @arsounet in #132
• Update README.md by @ashwin-nath-m in #129
• Bump dependabot/fetch-metadata from 2.4.0 to 2.5.0 by @dependabot[bot] in #140

New Contributors

• @ashwin-nath-m made their first contribution in #129
• @arsounet made their first contribution in #132
• @gp-lnuff made their first contribution in #133

Full Changelog: 4.0.0...4.1.0

What's Changed

• Filament v4 support

Full Changelog: 3.1.1...4.0.0

**what's changed

• Updated Readme
• Adds support for Filament 4.0
• New branch 4.x @bezhanSalleh

Full Changelog: 3.1.1...4.0.0-beta2

What's Changed

• Bump aglipanci/laravel-pint-action from 2.3.1 to 2.4 by @dependabot in #93
• Bump dependabot/fetch-metadata from 2.0.0 to 2.1.0 by @dependabot in #97
• Bump dependabot/fetch-metadata from 2.1.0 to 2.2.0 by @dependabot in #102
• Update flag.blade.php. Add alt text to img by @donatiss in #88
• Update README.md by @Saad5400 in #89
• Add max height to language switch dropdown by @michaelklopf in #100
• fixes wrongly overridded styles, now styles only the minimum styles needed by @inalto in #96
• Make route getName optional by @jyrkidn in #101
• Bump dependabot/fetch-metadata from 2.2.0 to 2.3.0 by @dependabot in #113
• Bump aglipanci/laravel-pint-action from 2.4 to 2.5 by @dependabot in #114
• Bump dependabot/fetch-metadata from 2.3.0 to 2.4.0 by @dependabot in #120
• add data-nosnippet to language switcher dropdown by @AurelDemiri in #122

New Contributors

• @donatiss made their first contribution in #88
• @Saad5400 made their first contribution in #89
• @inalto made their first contribution in #96
• @jyrkidn made their first contribution in #101
• @AurelDemiri made their first contribution in #122

Full Changelog: 3.1.0...3.1.1

What's Changed

• Preferred User and Browser Locales by @bezhanSalleh in #78
• Updates README.md by @fsamapoor in #76

New Contributors

• @fsamapoor made their first contribution in #76

Full Changelog: 3.0.6...3.1.0

What's Changed

• Bump dependabot/fetch-metadata from 1.6.0 to 2.0.0 by @dependabot in #85
• remove laravel explicit version dependency by @bezhanSalleh in #86

Full Changelog: 3.0.5...3.0.6

What's Changed

• fix middleware return type by @bezhanSalleh in https://github.com/bezhanSalleh/filament-language-switch/pull/80

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/3.0.4...3.0.5

What's Changed

• fix configurable trait usage by @bezhanSalleh in https://github.com/bezhanSalleh/filament-language-switch/pull/72

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/3.0.3...3.0.4

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/3.0.2...3.0.3

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/3.0.1...3.0.2

What's Changed

• Bump aglipanci/laravel-pint-action from 2.3.0 to 2.3.1 by @dependabot in https://github.com/bezhanSalleh/filament-language-switch/pull/66
• [Feature] Added LocaleChanged event by @michaelklopf in https://github.com/bezhanSalleh/filament-language-switch/pull/61
• [Fix] Browser Locale issue by @bezhanSalleh in https://github.com/bezhanSalleh/filament-language-switch/pull/69

New Contributors

• @michaelklopf made their first contribution in https://github.com/bezhanSalleh/filament-language-switch/pull/61

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/3.0.0...3.0.1

What's Changed

• Complete rewrite [3.x]

  • No Panel registeration required

  • Automatically boots after installation

  • Easily Configurable

  • Flags Support (no third-party packages required)

  • outside panels 'auth pages'

    • Display
    • Placement(position)

  • much more ...

for more checkout @bezhanSalleh in https://github.com/bezhanSalleh/filament-language-switch/pull/57

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/2.0.1...3.0.0

What's Changed

• Fixing dropdown cropped on safari by @dev3k in https://github.com/bezhanSalleh/filament-language-switch/pull/38
• Fixed test action
• Added the new banner

New Contributors

• @dev3k made their first contribution in https://github.com/bezhanSalleh/filament-language-switch/pull/38

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/2.0.0...2.0.1

What's new in 2.0.0?

• Filament v3.0.0 support

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/1.0.8...2.0.0

What's Changed

• Added the ability to configure and customize the render Hook
• Bump dependabot/fetch-metadata from 1.3.6 to 1.4.0 by @dependabot in https://github.com/bezhanSalleh/filament-language-switch/pull/26
• Bump dependabot/fetch-metadata from 1.4.0 to 1.5.1 by @dependabot in https://github.com/bezhanSalleh/filament-language-switch/pull/31
• Bump aglipanci/laravel-pint-action from 2.2.0 to 2.3.0 by @dependabot in https://github.com/bezhanSalleh/filament-language-switch/pull/30
• Bump dependabot/fetch-metadata from 1.5.1 to 1.6.0 by @dependabot in https://github.com/bezhanSalleh/filament-language-switch/pull/34
• Determine the locale of the user's browser. by @nikosid in https://github.com/bezhanSalleh/filament-language-switch/pull/27
• Fix Request a feature issue template by @ziming in https://github.com/bezhanSalleh/filament-language-switch/pull/32

New Contributors

• @nikosid made their first contribution in https://github.com/bezhanSalleh/filament-language-switch/pull/27
• @ziming made their first contribution in https://github.com/bezhanSalleh/filament-language-switch/pull/32

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/1.0.7...1.0.8

What's Changed

• Bump aglipanci/laravel-pint-action from 1.0.0 to 2.2.0 by @dependabot in https://github.com/bezhanSalleh/filament-language-switch/pull/23
• fixes #20, fixes #22 and fixes #24 by @bezhanSalleh in https://github.com/bezhanSalleh/filament-language-switch/pull/25

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/1.0.6...1.0.7

What's Changed

• Bump dependabot/fetch-metadata from 1.3.5 to 1.3.6 by @dependabot in https://github.com/bezhanSalleh/filament-language-switch/pull/16
• Update language-switch.blade.php by @mustafa-online in https://github.com/bezhanSalleh/filament-language-switch/pull/15
• Fixes #17 and Laravel 10 Support by @bezhanSalleh in https://github.com/bezhanSalleh/filament-language-switch/pull/18

New Contributors

• @mustafa-online made their first contribution in https://github.com/bezhanSalleh/filament-language-switch/pull/15

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/1.0.5...1.0.6

What's Changed

• fix register-middleware by @medeiroz in https://github.com/bezhanSalleh/filament-language-switch/pull/14

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/1.0.4...1.0.5

What's Changed

• Bump dependabot/fetch-metadata from 1.3.4 to 1.3.5 by @dependabot in https://github.com/bezhanSalleh/filament-language-switch/pull/11
• issue-12 fixed registration component to work with laravel octane by @medeiroz in https://github.com/bezhanSalleh/filament-language-switch/pull/13

New Contributors

• @medeiroz made their first contribution in https://github.com/bezhanSalleh/filament-language-switch/pull/13

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/1.0.3...1.0.4

What's Changed

• Fix light and dark mode issue by @bezhanSalleh in https://github.com/bezhanSalleh/filament-language-switch/pull/10

New Contributors

• @bezhanSalleh made their first contribution in https://github.com/bezhanSalleh/filament-language-switch/pull/10

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/1.0.2...1.0.3

What's Changed

• Bump dependabot/fetch-metadata from 1.3.3 to 1.3.4 by @dependabot in https://github.com/bezhanSalleh/filament-language-switch/pull/6
• fix: Fixed dark mode issues by @LukasFreyCZ in https://github.com/bezhanSalleh/filament-language-switch/pull/8

New Contributors

• @LukasFreyCZ made their first contribution in https://github.com/bezhanSalleh/filament-language-switch/pull/8

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/1.0.1...1.0.2

What's Changed

• Language flag is now optional

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/v1.0.0...1.0.1

What's Changed

• adjust switch spacing
• Bump dependabot/fetch-metadata from 1.3.1 to 1.3.3 by @dependabot in https://github.com/bezhanSalleh/filament-language-switch/pull/4
• Fix readme typo by @erjanmx in https://github.com/bezhanSalleh/filament-language-switch/pull/3

New Contributors

• @dependabot made their first contribution in https://github.com/bezhanSalleh/filament-language-switch/pull/4
• @erjanmx made their first contribution in https://github.com/bezhanSalleh/filament-language-switch/pull/3

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/compare/v0.0.1...v1.0.0

• minor wording issue: s/SwtichLanguageLocale/SwitchLanguageLocale
• introduce ability to set locale via query string (get parameter ?locale=xx)

Full Changelog: https://github.com/bezhanSalleh/filament-language-switch/commits/v0.0.0

• inception