NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #1735 most downloaded on pub.dev
Streamlined Flutter widget for versatile multi-selection with extensive customization.
Latest stable
4.0.0
Last release 18 days ago
04 Nov 2026
Ships unpredictably
gaps range from 2 weeks to 1.5 years
Nearly every release is documented
notes for 25 of 25 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
34 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Version 4 moves to material_ui and requires Flutter 3.47+ / Dart 3.13+. Update your Material imports, app theme, and decorations together. See the mig
Version 4 moves to material_ui and requires Flutter 3.47+ / Dart 3.13+. Update your Material imports, app theme, and decorations together. See the migration guide.
dart:io platform detection, restoring Web support.Validated with 183 package tests, 29 example tests, iOS/web builds, and a local Pana score of 160/160.
package:material_ui/material_ui.dart. Consumers must migrate their Material imports and app theme; see the README migration guide.material_ui ^1.4.0.ListTile items reporting hidden backgrounds and ink splashes.dart:io import used for desktop keyboard shortcuts (#130).InputBorder? and render correctly in overlay and bottom-sheet modes, without dynamic casts.DropdownDecoration.border, #228).ChipDecoration.wrapMaxHeight (#229).Your coding agent can read these notes before it upgrades. Set up the MCP server →
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 backgroun
ListTile in Material(type: MaterialType.transparency) to fix debug assertion when items have a background color (#220)overflowLabelBuilder for localizing "+N more" chip label (#217)Full Changelog: https://github.com/oi-narendra/multiselect-dropdown/compare/v3.1.0...v3.1.1
Full Changelog: https://github.com/oi-narendra/multiselect-dropdown/compare/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.
One column per quarter.