multi_dropdown
Streamlined Flutter widget for versatile multi-selection with extensive customization.
3.2.2
37K downloads/mo
#1686 most downloaded on pub.dev
oi-narendra/multiselect-dropdown
What this package is like to depend on
Last release 9 days 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
4 releases in the last 12 months
see the full history below
Release timeline
33 releases · Aug 2022 to Aug 2026
2023
2024
2025
2026
Releases
latest 33-
3.2.215 Aug 2026Release notes
Open source →Changed
- License: Switched from GPL-3.0 to MIT for broader adoption in commercial Flutter apps
Bug Fixes
- Field InkWell Material ancestor: Wrap the field
InkWellinMaterial(type: MaterialType.transparency)so the dropdown no longer crashes with "No Material widget found" on Flutter 3.47+ (#223, #224) - CI publish dry-run: Commit Flutter 3.47
analysis_options.yamlexcludes soflutter pub getno longer dirties the tree and fails dry-run validation
-
3.2.101 Jul 2026Release notes
Open source →Bug Fixes
- ListTile on Flutter 3.44+: Wrap dropdown item
ListTileinMaterial(type: MaterialType.transparency)to fix debug assertion when items have a background color (#220) - Viewport overflow: Clamp overlay dropdown height to available screen space so items remain reachable via scroll on small viewports (#221)
Also includes v3.2.0
Release notes
Open source →Bug Fixes
- ListTile on Flutter 3.44+: Wrap dropdown item
ListTileinMaterial(type: MaterialType.transparency)to fix debug assertion when items have a background color (#220) - Viewport overflow: Clamp overlay dropdown height to available screen space so items remain reachable via scroll on small viewports (#221)
- ListTile on Flutter 3.44+: Wrap dropdown item
-
3.1.117 Feb 2026Release notes
Open source →Bug Fixes
- Dropdown list padding: Remove default
MediaQuerypadding from dropdownListViewthat caused blank space at top/bottom of items on real devices (#120, #172)
Features
- List padding: Added
listPaddingtoDropdownDecorationfor custom padding around the items list (#120, #172)
- Dropdown list padding: Remove default
-
3.1.014 Feb 2026Release notes
Open source →Bug Fixes
- Cursor: Use pointer cursor instead of grab cursor on web/desktop (#158)
- Disabled state: Prevent interaction with clear icon and chip delete when disabled (#173, #174)
- Disabled state: Use theme colors for disabled elements instead of hardcoded grey (#174)
- Disabled icon: Apply
disabledTextColorand renderdisabledIconcorrectly (#199) - Keyboard: Dismiss keyboard before opening dropdown overlay (#136)
- Controller: Fix stale search results when calling
setItems(#142, #188, #190) - Controller: Keep filtered items in sync after
selectWhere/unselectWhere(#145) - Selected items: Respect
chipDecoration.wrapwhen usingselectedItemBuilder(#170) - Positioning: Improved auto-positioning to compare space above vs below (#147)
- Scroll: Allow page scrolling when dropdown overlay is open (#209)
Features
- Single-select styling: Added
selectedItemTextStyletoFieldDecorationfor styling the selected item text in single-select mode (#137, #195) - Search field: Added
textStyle,hintStyle,fillColor,filled,cursorColor,showClearIcon, andautofocustoSearchFieldDecoration(#155, #152, #160, #165, #206) - Dropdown items: Added
textStyleandselectedTextStyletoDropdownItemDecoration(#175, #197) - No items text: Added
noItemsFoundTexttoDropdownDecoration(#201) - Icon types: Changed
selectedIcon,disabledIcon, anddeleteIcontypes fromIcon?toWidget?(#200) - Chip overflow: Added
maxDisplayCounttoChipDecorationto limit visible chips and show "+N more" label (#194, #187) - Input decoration: Added
inputDecorationtoFieldDecorationfor fullInputDecorationoverride (#141, #150) - Expand direction: Added
ExpandDirectionenum (auto,up,down) toDropdownDecoration(#210) - Controller: Added public
clearSearch()method toMultiSelectController
-
3.0.117 Aug 2024Release notes
Open source →- Fixed overlay exception error.
- Fixed Text Direction issue.
- Exposed
OnSearchChangecallback to get the search query. - Fixed dropdown reset issue when used inside a
ListView. - Close dropdown when single select item is selected.
-
3.0.004 Aug 2024Release notes
Open source →Breaking Changes
- Multiple breaking changes have been made to the library to make it more flexible and customizable.
- The library has been completely rewritten to make it more flexible and customizable.
MultiSelectDropDownis nowMultiDropdown.ValueItemis nowDropdownItem. It now supportsdisabled&selectedproperties.- Added
.futureconstructor toMultiDropdownto support future options. It now shows a loading indicator when the future is being resolved. .customconstructor is now removed. You need to handle custom network requests manually by using the.futureconstructor.- Dropdown now supports
Form Validation,Prefix Iconand some other properties. - Dropdown now somewhat takes decoration from theme, to make the UI more consistent across the app.
- Refer to the parameters of the
MultiDropdownwidget for more information.
-
3.0.0-dev.502 Aug 2024 pre-release -
3.0.0-dev.402 Aug 2024 pre-releaseRelease notes
Open source →- Fixed
searchfeature not working issue. - Fixed
itemBuildernot working properly.
- Fixed
-
3.0.0-dev.301 Aug 2024 pre-release -
3.0.0-dev.211 May 2024 pre-releaseRelease notes
Open source →- Added
backgroundColorproperty toFieldDecorationto set the background color of the dropdown field. - Fixed issue with
onSelectionChangecallback.
- Added
-
3.0.0-dev.130 Apr 2024 pre-releaseRelease notes
Open source →- Multiple breaking changes have been made to the library to make it more flexible and customizable.
- The library has been completely rewritten to make it more flexible and customizable.
-
3.0.0-beta.101 Aug 2024 pre-releaseRelease notes
Open source →- Added
closeOnBackButtonproperty toMultiDropdownto close the dropdown when the back button is pressed. - Added
footerandheaderproperties toDropdownDecorationto add a custom footer and header to the dropdown. - When dropdown is opened, now it supports gesture in the background as well. Example: You can now scroll the list behind the dropdown, when the dropdown is open.
prefixIconinFieldDecorationis now aWidgetinstead of anIcon.- Fixed dropdown not opening on web.
- Fixed an issue causing validation to not work properly when using controller to update the dropdown.
- Renamed controller's
.openmethod to.showDropdownand.hidemethod to.closeDropdown.
- Added
-
2.1.411 Feb 2024Release notes
Open source →- Removed
showClearIconproperty from dropdown field. Use clearIcon property to set the clear icon. If clearIcon is null, the clear icon will not be shown. - Added
singleSelectItemStyleproperty to dropdown field. Use this property to set the style of the selected item in single select dropdown. - Fixed suffixIcon animation issue in dropdown field, also added
animateSuffixIconproperty to enable/disable suffix icon animation. - Added
optionBuilderproperty to dropdown field. Use this property to build custom dropdown options.
- Removed
-
2.1.330 Dec 2023Release notes
Open source →- Added dropdown background color property, search field background color property, and search field label property.
- Added onDelete callback to dropdown field. This callback is called when option is deleted from the dropdown field using the delete icon/button in chips.
-
2.1.204 Dec 2023Release notes
Open source →- Fixed dropdown dismiss issue when search is enabled and option is/are selected on web.
- Fixed the issue where the selected options were ignored when the widget is rebuilt.
-
2.1.122 Nov 2023Release notes
Open source →- Added dropdown margin property. Use this property to set the margin between the dropdown field and the dropdown.
- Added dropdownborderradius property. Use this property to set the border radius of the dropdown.
- Fixed controller being used after being disposed.
-
2.1.013 Sep 2023 -
2.0.211 Sep 2023Release notes
Open source →- Added support for custom suffix icon in dropdown field.
- Added support for custom clear icon in dropdown field.
- Fixed the issue where the dropdown would not follow the dropdown field when the dropdown field is scrolled.
- Updated http dependency to 1.1.0.
-
2.0.109 Jul 2023Release notes
Open source →- 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 selected.
- Upgraded http dependency to 1.0.0.
-
2.0.017 May 2023 -
2.0.0-dev.320 Mar 2023 pre-releaseRelease notes
Open source →- Fixed issue where selecting an option after passing initial options would not work.
-
2.0.0-dev.213 Mar 2023 pre-release -
2.0.0-dev.101 Mar 2023 pre-releaseRelease notes
Open source →- Added support for controller.
- Use controller to get/set selected options, disabled options, options, and enabled options.
- Use controller to clear selected options, show/hide dropdown.
- Added support for focusnode, use focusnode to focus/unfocus the dropdown field programmatically.
-
1.0.916 Feb 2023Release notes
Open source →- Added clear button to dropdown field.
- Added support focus on dropdown field.
-
1.0.803 Feb 2023Release notes
Open source →- Updated dropdown to detect available space and show the dropdown above or below the field.
-
1.0.727 Jan 2023 -
1.0.624 Dec 2022 -
1.0.512 Dec 2022Release notes
Open source →- Fixed onOptionsSelected callback not being called when deleting the chip item.
- Fixed issue causing overlay exception.
-
1.0.422 Nov 2022Release notes
Open source →- Added support for dropdown field padding, border color, border width, and border radius.
- Fixed onOptionsSelected callback not being called.
- Added toString/JsonSerialization/Equality/Hash methods to ValueItem class.
-
1.0.316 Nov 2022 -
1.0.220 Aug 2022 -
1.0.120 Aug 2022 -
1.0.020 Aug 2022