Filament v4.12.2: Bug Fixes for Forms & Tables | Mohamed Said [Skip to content](#main) [ ![](https://cdn.msaied.com/01KT78WE565VEMM3PSNQAAB0MH.png) Mohamed SaidLaravel Backend Engineer ](https://www.msaied.com/public) - [Home](https://www.msaied.com/public) - [Projects](https://www.msaied.com/public/projects) - [Articles](https://www.msaied.com/public/articles) - [Certificates](https://www.msaied.com/public/certificates) - [About](https://www.msaied.com/public#about) [ Contact](https://www.msaied.com/public#contact) Menu Menu ---- Close - [HomeStart here](https://www.msaied.com/public) - [ProjectsCase studies](https://www.msaied.com/public/projects) - [ArticlesEngineering notes](https://www.msaied.com/public/articles) - [CertificatesCredentials](https://www.msaied.com/public/certificates) - [AboutHow I work](https://www.msaied.com/public#about) - [ContactGet in touch](https://www.msaied.com/public#contact) [Start a conversation](https://www.msaied.com/public#contact) [WhatsApp](https://wa.me/201094619204) [Email](mailto:hello@msaied.com) 1. [Home](https://www.msaied.com/public) 2. / 3. [Articles](https://www.msaied.com/public/articles) 4. / 5. [Filament](https://www.msaied.com/public/articles?category=filament) 6. / 7. Filament v4.12.2 Released: Bug Fixes for Toggle, Builder, Repeater, and More [Filament](https://www.msaied.com/public/articles?category=filament) Filament v4.12.2 Released: Bug Fixes for Toggle, Builder, Repeater, and More ============================================================================= Filament v4.12.2 ships 19 bug fixes and improvements covering Toggle helper text visibility, Builder block picker null keys, Repeater item caching, MorphToSelect crashes, Markdown editor height, and table UI consistency. ![](https://cdn.msaied.com/01M22N44A70A5MC2S599JP0MPH.webp) [Mohamed Said](https://www.msaied.com/public#person) Published 22 Jul 2026 · Updated 23 Jul 2026 · 3 min read ShareCopy linkCopied ![Filament v4.12.2 Released: Bug Fixes for Toggle, Builder, Repeater, and More](https://cdn.msaied.com/459/61a5634aab232d224ca5392aa75ac7d9.png) 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 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) - [filament](https://www.msaied.com/public/articles?search=filament) - [laravel](https://www.msaied.com/public/articles?search=laravel) - [php](https://www.msaied.com/public/articles?search=php) - [bug-fix](https://www.msaied.com/public/articles?search=bug-fix) - [forms](https://www.msaied.com/public/articles?search=forms) - [accessibility](https://www.msaied.com/public/articles?search=accessibility) Frequently asked questions --------------------------- 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. 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. 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. ![Mohamed Said](https://cdn.msaied.com/01M22N44A70A5MC2S599JP0MPH.webp)About the author ---------------- [Mohamed Said](https://www.msaied.com/public#person)Senior Backend Engineer specializing in Laravel, scalable SaaS platforms, APIs, and cloud infrastructure. I build secure, high-performance web applications that help businesses grow. [About](https://www.msaied.com/public#about) [GitHub ↗](https://github.com/EG-Mohamed) [LinkedIn ↗](https://www.linkedin.com/in/msaiedm/) [WhatsApp ↗](https://wa.me/201094619204) [Email Address ↗](mailto:hello@msaied.com) [My CV ↗](https://drive.google.com/file/u/0/d/1MF20IPRJyzfy32mhEutjL5EpSls0w2Q8/view) [Previous articleFilament at Scale: Multi-Panel Auth, Custom Panels, and Table Query Tuning](https://www.msaied.com/public/articles/filament-at-scale-multi-panel-auth-custom-panels-and-table-query-tuning-3) [Next articleFilament v5.7.2 Released: Bug Fixes for Forms, Tables, and Accessibility](https://www.msaied.com/public/articles/filament-v572-released-bug-fixes-for-forms-tables-and-accessibility) 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) ### Have a technical challenge? Tell me what you’re building. I reply within two working days. [Start a conversation](https://www.msaied.com/public#contact) Related articles ----------------- [ ![](https://cdn.msaied.com/740/cce86edc21eddcbdd2f2454fadaf9c70.png) · 3 min read### The Pipeline Pattern in Laravel: Custom Pipelines Beyond Middleware 5 Oct 2026 ](https://www.msaied.com/public/articles/the-pipeline-pattern-in-laravel-custom-pipelines-beyond-middleware-1) [ ![](https://cdn.msaied.com/739/2d6897fdcdcf090613f96f72a64b8a78.png) · 4 min read### MySQL Full-Text Search in Laravel: Indexes, Relevance Scoring, and Boolean Mode 4 Oct 2026 ](https://www.msaied.com/public/articles/mysql-full-text-search-in-laravel-indexes-relevance-scoring-and-boolean-mode) [ ![](https://cdn.msaied.com/738/073696a3fefe18bec825beec5ac658f5.png) · 4 min read### Laravel Queue Rate-Limited Middleware: Throttling Jobs Without Losing Work 4 Oct 2026 ](https://www.msaied.com/public/articles/laravel-queue-rate-limited-middleware-throttling-jobs-without-losing-work) Have a technical challenge? ---------------------------- Tell me what you’re building. I reply within two working days. [Discuss your project ↗](https://www.msaied.com/public#contact) © 2026 Mohamed Said · Built with Laravel, meant to last.Senior Backend Engineer specializing in Laravel, scalable SaaS platforms, APIs, and cloud infrastructure. I build secure, high-performance web applications that help businesses grow. - [Home](https://www.msaied.com/public) - [Articles](https://www.msaied.com/public/articles) - [Certificates](https://www.msaied.com/public/certificates) - [GitHub](https://github.com/EG-Mohamed) - [LinkedIn](https://www.linkedin.com/in/msaiedm/) - [WhatsApp](https://wa.me/201094619204) - [Email Address](mailto:hello@msaied.com) - [My CV](https://drive.google.com/file/u/0/d/1MF20IPRJyzfy32mhEutjL5EpSls0w2Q8/view) - [Sitemap](https://www.msaied.com/public/sitemap.xml)