Searchable Selector

Category: Widgets
Subcategory: Input widgets


Mendix reference, reference set, and enumeration selector with a search bar and a clear button.

**If you are using Mendix 8.17 - 9.12**, use the following widget or check older version in the marketplace:  


Demo url

Searchable Selector

Mendix reference, reference set, and enumeration selector with a search bar and a clear button.

If you are using Mendix 8.17 - 9.12, please use the following widget or check older version in the marketplace. (The older version does not support reference sets or enumerations)

Dropdown Reference or EnumDropdown Reference SetDropdownRefDropdownRefSetList On Page Reference or EnumList On Page Reference SetListRefListRefSet

Note: checkboxes, radio buttons, or background color settings are independent. All can be used at any time


  • Dropdown or list selection for enumerations, references or reference sets
  • Can use "Max Items" setting to limit objects retrieved at once use if you encounter longer load times
  • Filtering is done by the Mendix runtime instead of the browser
  • Button to clear the selection / all selections - can be disabled
  • Button to select all the options in a reference set - can be disabled
  • Option to make the content un-searchable - allows you to show a dynamic list of checkboxes / radio buttons
  • Option to render options as checkboxes, radio buttons, or a cell
  • Option to render attribute text, HTML content, or content from Mendix
  • Option to render a reference set's values with either badges or as a comma separated list
  • Option to define your own filtering logic with a Microflow
  • Option to use either Contains or StartsWith functions
  • Ability to marked specific options as un-selectable
  • Ability to customize the icons
  • Support for arrow keys and enter key press
  • Searching auto-highlights the first record for easy selecting with the enter key


The following settings are available for all Selection Types.
The label is that text next to the textbox while the placeholder is the text inside of the textbox when there is no search.

Please see the following documentation based on the Selection Type you wish to use.

Check here for more information on using manual filtering. Many of the options are removed with the expectation you will be adding the features manually in you microflow data source.

Performance Issues?

You likely have too many options trying to render at once. Here's some things to help address the problem:

  • Try using the "Max Items" setting. This will limit the amount of options available on the first render and display the "More Results Text" at the end of the list. When a user searches for something, it will still consider the options that are not rendered
  • Try limiting the data source based on what you already know. For example, if your form is for selecting McDonald's locations. Make the user select a state or country first then use that information to limit the data source.
  • Too many badges displaying when you have a reference set? Use the "Max Reference Display" setting. This will only render the first x amount of badges then include (+x) for the number of remaining selected.
  • Only use the "Selectable Attribute" if you absolutely need it. Sometimes it is better to not display a record at all (e.g. adding xpath to the data source) instead of displaying it as un-selectable.

Demo project

Issues, suggestions and feature requests

This widget is open source. Feel free to clone the GitHub repository, make whatever changes you need, and submit a pull request! **Requires Node v14 and NPM v6 - if you already have a different version of Node / NPM, then download NVM to switch between versions **

Development and contribution

Benjamin Griggs


Version: 2.4.0
Framework Version: 9.13.0
Release Notes: - changed the options to be in a instead of a for compliance - added a loading state with text and an option to ignore selections while loading
Version: 2.3.0
Framework Version: 9.13.0
Release Notes: - fixed an issue with manual filtering where the user's typing would be ignored while the data source microflow is running.
Version: 1.2.6
Framework Version: 9.13.0
Release Notes: Parity changes with mx9 version - added enumeration support - added manual filtering option - added icon customization
Version: 1.0.0
Framework Version: 8.17.0
Release Notes: Initial upload