The `LinearProgressIndicator` and `CircularProgressIndicator` have been updated to match the Material 3 Design specifications.
Original behavior
The Material 3 Design specifications for the `LinearProgressIndicator` and `CircularProgressIndicator` were updated in December 2023.
New behavior
The `LinearProgressIndicator` and `CircularProgressIndicator` widgets each have a `year2023` flag that can be set to `false` to opt in to the updated design specification. The default value for the `year2023` flag is `true`, which means that the progress indicators use the 2023 design spec.
- Who is affected
- Applications and packages relying on the previous behaviour or signature. Code that uses LinearProgressIndicator, CircularProgressIndicator, LinearProgressIndicator.year2023 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.
Official migration guide (excerpt, © The Flutter Authors, CC BY 3.0)
To opt into the updated design spec for the LinearProgressIndicator,
set the year2023 flag to false:
LinearProgressIndicator(
year2023: false,
value: 0.5,
),To update your entire app to use the updated LinearProgressIndicator design,
set the ProgressIndicatorThemeData.year2023 property to false in your
MaterialApp:
return MaterialApp(
theme: ThemeData(progressIndicatorTheme: const ProgressIndicatorThemeData(year2023: false)),
// ...
LinearProgressIndicator(
year2023: false,
value: 0.5,
),
// ...To opt into the updated design spec for the CircularProgressIndicator,
set the year2023 flag to false:
CircularProgressIndicator(
year2023: false,
value: 0.5,
),To update your entire app to use the updated CircularProgressIndicator design,
set the ProgressIndicatorThemeData.year2023 property to false in your
MaterialApp:
return MaterialApp(
theme: ThemeData(progressIndicatorTheme: const ProgressIndicatorThemeData(year2023: false)),
// ...
CircularProgressIndicator(
year2023: false,
value: 0.5,
),
// ...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
- Update both ProgressIndicator for Material 3 redesign
- Update Material 3 LinearProgressIndicator for new visual style
- Update Material 3 CircularProgressIndicator for new visual style
- 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.