NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #1860 most downloaded on pub.dev
Streamlined Flutter widget for versatile multi-selection with extensive customization.
Last release 1 months ago
15 Aug 2026
Ships unpredictably
gaps range from 2 weeks to 1.5 years
Nearly every release is documented
notes for 24 of 24 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
33 releases · first in 2022
One column per quarter.
License: Switched from GPL-3.0 to MIT for broader adoption in commercial Flutter apps
InkWell in Material(type: MaterialType.transparency) so the dropdown no longer crashes with "No Material widget found" on Flutter 3.47+ (#223, #224)analysis_options.yaml excludes so flutter pub get no longer dirties the tree and fails dry-run validationListTile on Flutter 3.44+ : Wrap dropdown item ListTile in Material(type: MaterialType.transparency) to fix debug assertion when items have a backgrou
ListTile in Material(type: MaterialType.transparency) to fix debug assertion when items have a background color (#220)Full Changelog : v3.1.0...v3.1.1
Full Changelog: v3.1.0...v3.1.1
MediaQuery padding from dropdown ListView that caused blank space at top/bottom of items on real devices (#120, #172)listPadding to DropdownDecoration for custom padding around the items list (#120, #172)Cursor: Use pointer cursor instead of grab cursor on web/desktop
disabledTextColor and render disabledIcon correctly (#199)setItems (#142, #188, #190)selectWhere/unselectWhere (#145)chipDecoration.wrap when using selectedItemBuilder (#170)selectedItemTextStyle to FieldDecoration for styling the selected item text in single-select mode (#137, #195)textStyle, hintStyle, fillColor, filled, cursorColor, showClearIcon, and autofocus to SearchFieldDecoration (#155, #152, #160, #165, #206)textStyle and selectedTextStyle to DropdownItemDecoration (#175, #197)noItemsFoundText to DropdownDecoration (#201)selectedIcon, disabledIcon, and deleteIcon types from Icon? to Widget? (#200)maxDisplayCount to ChipDecoration to limit visible chips and show "+N more" label (#194, #187)inputDecoration to FieldDecoration for full InputDecoration override (#141, #150)ExpandDirection enum (auto, up, down) to DropdownDecoration (#210)clearSearch() method to MultiSelectControllerUpdate package version to 3.0.1
Update package version to 3.0.1
OnSearchChange callback to get the search query.ListView.chore: Update MultiDropdown widget to v3.0.0 with breaking changes an…
chore: Update MultiDropdown widget to v3.0.0 with breaking changes an…
MultiSelectDropDown is now MultiDropdown.ValueItem is now DropdownItem. It now supports disabled & selected properties..future constructor to MultiDropdown to support future options. It now shows a loading indicator when the future is being resolved..custom constructor is now removed. You need to handle custom network requests manually by using the .future constructor.Form Validation, Prefix Icon and some other properties.MultiDropdown widget for more information.height property in DropdownDecoration is renamed to maxHeight.
height property in DropdownDecoration is renamed to maxHeight.Fixed search feature not working issue.
search feature not working issue.itemBuilder not working properly.Fixed issue causing onSelectionChange callback to not work properly.
onSelectionChange callback to not work properly.Added backgroundColor property to FieldDecoration to set the background color of the dropdown field.
backgroundColor property to FieldDecoration to set the background color of the dropdown field.onSelectionChange callback.Multiple breaking changes have been made to the library to make it more flexible and customizable.
Added closeOnBackButton property to MultiDropdown to close the dropdown when the back button is pressed.
closeOnBackButton property to MultiDropdown to close the dropdown when the back button is pressed.footer and header properties to DropdownDecoration to add a custom footer and header to the dropdown.prefixIcon in FieldDecoration is now a Widget instead of an Icon..open method to .showDropdown and .hide method to .closeDropdown.Removed showClearIcon property from dropdown field. Use clearIcon property to set the clear icon. If clearIcon is null, the clear icon will not be sho
showClearIcon property from dropdown field. Use clearIcon property to set the clear icon. If clearIcon is null, the clear icon will not be shown.singleSelectItemStyle property to dropdown field. Use this property to set the style of the selected item in single select dropdown.animateSuffixIcon property to enable/disable suffix icon animation.optionBuilder property to dropdown field. Use this property to build custom dropdown options.Added dropdown background color property, search field background color property, and search field label property.
Fixed dropdown dismiss issue when search is enabled and option is/are selected on web.
Added dropdown margin property. Use this property to set the margin between the dropdown field and the dropdown.
Added support for search in dropdown options.
Added support for custom suffix icon in dropdown field.
Added maxItems property to dropdown field. If max items is set, the dropdown field will not allow more than the specified number of items to be select
- Stable release.
Fixed issue where selecting an option after passing initial options would not work.
Fixed issue where chips were not being cleared when controller not set.
Use controller to get/set selected options, disabled options, options, and enabled options.
Added clear button to dropdown field.
Updated dropdown to detect available space and show the dropdown above or below the field.
Added custom border radius in dropdown.
Fixed selected option text color not being applied.
Fixed onOptionsSelected callback not being called when deleting the chip item.
Added support for dropdown field padding, border color, border width, and border radius.
Added new constructor that supports fetching the data from a URL.
- Added example.
- Updated screenshots.
- Initial release.
Your coding agent can read these notes before it upgrades. Set up the MCP server →