Flutter 3.41 is live! Check out theFlutter 3.41 blog post!
Deprecated the 'value' parameter of the 'DropdownButtonFormField' constructor
The `DropdownButtonFormField` constructor parameter `value` has been replaced by the parameter `initialValue`.
These breaking change docs are accurate, as of the release under which they are published. Over time, the workarounds described here might become inaccurate. We don't, in general, keep these breaking change docs up to date as of each release.
Thebreaking change index file lists the docs created for each release.
Summary
# Thevalue parameter of theDropdownButtonFormField constructor was deprecated in favor of theinitialValue parameter.
Context
# Thevalue parameter of theDropdownButtonFormField constructor was used to initializeDropdownButtonFormField.initialValue. Not using the same name was confusing. For example, developers falsely assumed that settingvalue would change the current selected value. This was not the case—it only set the initial value or when the field is reset.
Description of change
# Thevalue parameter of theDropdownButtonFormField constructor is deprecated in favor of the parameter namedinitialValue.
Migration guide
# Replace thevalue parameter of theDropdownButtonFormField constructor with theinitialValue parameter to initializeDropdownButtonFormField.initialValue.
Code before migration:
DropdownButtonFormField(value:'Yellow',),Code after migration:
DropdownButtonFormField(initialValue:'Yellow',),Timeline
# Landed in version: 3.35.0-0.0.pre
In stable release: 3.35
References
#API documentation:
Relevant issues:
Relevant PRs:
Unless stated otherwise, the documentation on this site reflects Flutter 3.38.6. Page last updated on 2025-10-28.View source orreport an issue.