The `ui.ImageFilter.blur`'s default tile mode is now automatically selected by the backend. Previously `TileMode.clamp` was used unless a different tile mode was specified. Now, the default is `null` and specifies automatic selection unless a specific tile mode is specified.
- Who is affected
- Applications and packages relying on the previous behaviour or signature. Code that uses TileMode.clamp, ImageFilter.blur, Tilemode.repeated and related APIs.
- Practical impact
- Behaviour or API differences that can break builds or change runtime behaviour.
- What action should I take?
- Follow the official migration guide below, update affected call sites, run `dart fix --apply` where a fix is available, then run your tests.
Before and after (from the official guide)
| 1 | − | final filter = ui.ImageFilter.blur(sigmaX: 4, sigmaY: 4, tileMode: TileMode.decal); |
| 1 | + | final filter = ui.ImageFilter.blur(sigmaX: 4, sigmaY: 4); |
Raw before / after
final filter = ui.ImageFilter.blur(sigmaX: 4, sigmaY: 4, tileMode: TileMode.decal);
final filter = ui.ImageFilter.blur(sigmaX: 4, sigmaY: 4);
Official migration guide (excerpt, © The Flutter Authors, CC BY 3.0)
Only blur image filters that don't specify an explicit tile mode are impacted by this change.
We believe that the new defaults are generally better and would recommend removing any specified blur tile modes.
Code before migration:
final filter = ui.ImageFilter.blur(sigmaX: 4, sigmaY: 4, tileMode: TileMode.decal);Code after migration:
final filter = ui.ImageFilter.blur(sigmaX: 4, sigmaY: 4);AI_PROVIDER (for example to openai-compatible with a local Ollama or LM Studio endpoint) to enable grounded explanations. Everything else on this page works without an AI provider.Listed in the official breaking-changes index (docs.flutter.dev/release/breaking-changes).
An official announcement or migration guide documents an intended behaviour or API change. A verified source change (git diff) shows code changed but does not by itself prove a public API is breaking. AI interpretations are labelled and never used to classify a change.
- Official migration guide
- ImageFilter
- TileMode
- Issue #154935
- Issue #110318
- Issue #157693
- Change default TileMode for blur ImageFilter objects to null
- Source commit
- b3045439b7c0
- Source last updated
- Oct 21, 2026
- Last synchronized
- Oct 21, 2026
- Publication status
- published
Publication history
- Oct 21, 2026, 8:31 PM: new → published (ingestion) — Backed by an official breaking-change/migration guide.
AI_PROVIDER (for example to openai-compatible with a local Ollama or LM Studio endpoint) to enable grounded explanations. Everything else on this page works without an AI provider.