Filament v4.12.2: Bug Fixes for Forms & Tables | Mohamed Said [ ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MH.png) Mohamed Said Laravel Backend Engineer ](https://msaied.com) [ Home ](https://msaied.com) [ Projects ](https://msaied.com/projects) [ Articles ](https://msaied.com/articles) [ Certificates ](https://msaied.com/certificates) [ Contact ](https://msaied.com#contact-section) [ ](https://github.com/EG-Mohamed) [ Home ](https://msaied.com) [ Projects ](https://msaied.com/projects) [ Articles ](https://msaied.com/articles) [ Certificates ](https://msaied.com/certificates) [ Contact ](https://msaied.com#contact-section) [ home ](https://msaied.com) [ articles ](https://msaied.com/articles) Filament v4.12.2 Released: Bug Fixes for Toggle, Builder, Repeater, and More On this page 1. [ Filament v4.12.2 Is Out — Here's What Changed ](#filament-v4122-is-out-heres-what-changed) 2. [ Form Component Fixes ](#form-component-fixes) 3. [ Table UI Consistency ](#table-ui-consistency) 4. [ Navigation and Configuration Context ](#navigation-and-configuration-context) 5. [ Accessibility Improvements ](#accessibility-improvements) 6. [ BackedEnum Tab Badge Icons ](#backedenum-tab-badge-icons) 7. [ Non-Interactive Relation Manager Generation ](#non-interactive-relation-manager-generation) 8. [ Facade Doc Block Correction ](#facade-doc-block-correction) 9. [ Spanish Translations Updated ](#spanish-translations-updated) 10. [ Key Takeaways ](#key-takeaways) 11. [ How to Upgrade ](#how-to-upgrade) ![Filament v4.12.2 Released: Bug Fixes for Toggle, Builder, Repeater, and More](https://cdn.msaied.com/459/61a5634aab232d224ca5392aa75ac7d9.png) [ Filament ](https://msaied.com/articles?category=filament) #filament #laravel #php #bug-fix #forms #accessibility Filament v4.12.2 Released: Bug Fixes for Toggle, Builder, Repeater, and More ============================================================================== 22 Jul 2026 3 min read ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said Table of contents 11 sections 1. [ 01 Filament v4.12.2 Is Out — Here's What Changed ](#filament-v4122-is-out-heres-what-changed) 2. [ 02 Form Component Fixes ](#form-component-fixes) 3. [ 03 Table UI Consistency ](#table-ui-consistency) 4. [ 04 Navigation and Configuration Context ](#navigation-and-configuration-context) 5. [ 05 Accessibility Improvements ](#accessibility-improvements) 6. [ 06 BackedEnum Tab Badge Icons ](#backedenum-tab-badge-icons) 7. [ 07 Non-Interactive Relation Manager Generation ](#non-interactive-relation-manager-generation) 8. [ 08 Facade Doc Block Correction ](#facade-doc-block-correction) 9. [ 09 Spanish Translations Updated ](#spanish-translations-updated) 10. [ 10 Key Takeaways ](#key-takeaways) 11. [ 11 How to Upgrade ](#how-to-upgrade) Filament v4.12.2 Is Out — Here's What Changed --------------------------------------------- Released on 22 July 2026, Filament v4.12.2 is a focused patch release that resolves 19 issues reported by the community. No new features are introduced; the goal is stability and polish across forms, tables, navigation, and accessibility. ### Form Component Fixes Several form-related bugs received attention in this release. **Toggle helper text visibility** — When a `Toggle` field used `inlineLabel()`, `live()`, and had a `false` value, the `helperText` was incorrectly hidden. This is now resolved. **Builder block picker null array keys** — The Builder component could crash when block definitions produced `null` array keys. The fix prevents null keys from being used in the block picker. **Builder / Repeater / RepeatableEntry item cache** — Item caching was not correctly keyed on state, which could cause stale renders. The cache is now based on the actual component state. **Spatie Media Library reordering in Repeater** — Drag-to-reorder inside a Repeater backed by Spatie Media Library was broken and has been corrected. **MorphToSelect crash in live Repeater** — Adding a new item to a `live()` Repeater that contained a `MorphToSelect` field triggered a crash. This edge case is now handled gracefully. **Markdown editor `minHeight()` ignored when `maxHeight()` is set** — Setting both constraints on a Markdown editor caused `minHeight()` to be disregarded. Both values are now respected independently. **CodeMirror refresh on visibility change** — The CodeMirror instance powering the Markdown editor was not refreshing when the editor became visible (e.g., inside a tab). It now reinitialises correctly. **OptionState accepts Stringable** — `OptionState` previously required a plain string. It now accepts any `Stringable` object, making it more flexible when working with value objects or enums. ### Table UI Consistency Two visual fixes land for the table component: - Action buttons in the table toolbar are now the same height as the search bar, eliminating the awkward size mismatch. - The `fi-ta-header-toolbar` element now enforces a minimum height, preventing layout collapse when the toolbar is sparsely populated. - Table header height consistency and button loading height have also been normalised. ### Navigation and Configuration Context A fix ensures that the configuration context is preserved when mounting navigation. Previously, switching between panels or mounting navigation dynamically could lose panel-specific configuration. ### Accessibility Improvements - The non-native date/time picker panel now has accessible names, improving screen-reader support. - The focused skip link is now visible, fixing a regression that made keyboard navigation harder. - Modal focus restoration no longer causes unwanted scrolling when a modal closes. ### BackedEnum Tab Badge Icons Tab badge icons sourced from `BackedEnum` cases were not rendering correctly. This is now fixed. ### Non-Interactive Relation Manager Generation Generating a non-interactive relation manager without an existing relationship no longer throws an error. ### Facade Doc Block Correction The `Filament` facade's PHPDoc block has been updated to match the actual method signatures, improving IDE autocompletion accuracy. ### Spanish Translations Updated Spanish locale strings have been refreshed by community contributor `@luisprmat`. --- ### Key Takeaways - **Toggle + inlineLabel + live + false value**: helper text is now always visible. - **Builder block picker**: null array keys are blocked at the source. - **Repeater item cache**: keyed on state, preventing stale UI. - **MorphToSelect in live Repeater**: no longer crashes on item add. - **Markdown editor**: `minHeight()` and `maxHeight()` now coexist correctly. - **Table toolbar**: button heights and minimum toolbar height are consistent. - **Accessibility**: skip link, date picker ARIA names, and modal scroll all improved. ### How to Upgrade Run the following command in your Laravel project: ```bash composer update filament/filament ``` No configuration changes or migrations are required for this patch release. --- [View the full release notes on GitHub](https://github.com/filamentphp/filament/releases/tag/v4.12.2) Found this useful? [ ](https://twitter.com/intent/tweet?url=https%3A%2F%2Fmsaied.com%2Farticles%2Ffilament-v4122-released-bug-fixes-for-toggle-builder-repeater-and-more&text=Filament+v4.12.2+Released%3A+Bug+Fixes+for+Toggle%2C+Builder%2C+Repeater%2C+and+More) [ ](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fmsaied.com%2Farticles%2Ffilament-v4122-released-bug-fixes-for-toggle-builder-repeater-and-more) Frequently Asked Questions ---------------------------- 3 questions Q01 What was the Toggle helper text bug fixed in Filament v4.12.2? When a Toggle field used inlineLabel(), live(), and had a value of false, the helperText was incorrectly hidden. Filament v4.12.2 ensures the helper text is always rendered regardless of the toggle's boolean state. Q02 Why was the Repeater item cache causing stale renders before v4.12.2? The item cache for Builder, Repeater, and RepeatableEntry components was not keyed on the component's actual state, so cached items could persist even after state changes. The fix keys the cache on state, ensuring renders always reflect current data. Q03 Does upgrading to Filament v4.12.2 require any database migrations or config changes? No. v4.12.2 is a patch release containing only bug fixes. You can upgrade by running `composer update filament/filament` without any additional migration or configuration steps. Continue reading More Articles --------------- [ View all ](https://msaied.com/articles) [ ![Laravel Founders Summit 2026: A One-Day Gathering for Laravel Business Leaders](https://cdn.msaied.com/461/12537bd0a10d8e3a3a6aea18a1e8a8d5.png) Laravel Founders Summit Laravel Events ### Laravel Founders Summit 2026: A One-Day Gathering for Laravel Business Leaders Laravel has opened applications for the Founders Summit, a one-day invite-only event in November 2026 for foun... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 23 Jul 2026 3 min read Read ](https://msaied.com/articles/laravel-founders-summit-2026-a-one-day-gathering-for-laravel-business-leaders) [ ![Laravel's First-Party Image Processing: A Practical Guide to Illuminate\Image](https://cdn.msaied.com/460/5cb923ccb4db6434fec59637652666f0.png) Laravel Image Processing Illuminate\\Image ### Laravel's First-Party Image Processing: A Practical Guide to Illuminate\\Image Laravel 13.20 ships a fluent, immutable image processing API via Illuminate\\Image, backed by Intervention Imag... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 23 Jul 2026 3 min read Read ](https://msaied.com/articles/laravels-first-party-image-processing-a-practical-guide-to-illuminateimage) [ ![6 Laravel UI Kits and Component Libraries for 2025 (Tailwind v4 + Livewire)](https://cdn.msaied.com/457/dba84fd2829714df4374ab87d7378b51.png) Laravel Tailwind CSS Livewire ### 6 Laravel UI Kits and Component Libraries for 2025 (Tailwind v4 + Livewire) A hands-on comparison of six Laravel Blade UI component libraries—Flowbite, daisyUI, Preline, maryUI, Sheaf UI... ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MJ.jpg) Mohamed Said 22 Jul 2026 4 min read Read ](https://msaied.com/articles/6-laravel-ui-kits-and-component-libraries-for-2025-tailwind-v4-livewire) [ ![Mohamed Said](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MH.png) Mohamed Said Laravel Backend Engineer ](https://msaied.com)Senior Backend Engineer specializing in Laravel, scalable SaaS platforms, APIs, and cloud infrastructure. I build secure, high-performance web applications that help businesses grow. Explore - [Home](https://msaied.com) - [Projects](https://msaied.com/projects) - [Articles](https://msaied.com/articles) - [Certificates](https://msaied.com/certificates) - [Contact](https://msaied.com#contact-section) Connect - [ hello@msaied.com ](mailto:hello@msaied.com) - [ +20 109 461 9204 ](tel:+201094619204) © 2026 Mohamed Said. All rights reserved. [ ](https://github.com/EG-Mohamed) [ ](https://www.linkedin.com/in/msaiedm/) [ ](https://wa.me/201094619204) [ ](mailto:hello@msaied.com) [ ](https://drive.google.com/file/u/0/d/1MF20IPRJyzfy32mhEutjL5EpSls0w2Q8/view)