select2/docs/pages/03.configuration/01.options-api/docs.md

---

title: Options taxonomy:

category: docs

---

This is a list of all the Select2 configuration options.

Option	Type	Default	Description
ajax	object	null	Provides support for ajax data sources.
allowClear	boolean	false	Provides support for clearable selections.
amdLanguageBase	string	./i18n/	See Using Select2 with AMD or CommonJS loaders.
closeOnSelect	boolean	true	Controls whether the dropdown is closed after a selection is made.
data	array of objects	null	Allows rendering dropdown options from an array.
dataAdapter		SelectAdapter	Used to override the built-in DataAdapter.
debug	boolean	false	Enable debugging messages in the browser console.
dir	string	ltr	Sets the dir attribute on the selection and dropdown containers to indicate the direction of the text.
disabled	boolean	false	When set to true, the select control will be disabled.
dropdownAdapter		DropdownAdapter	Used to override the built-in DropdownAdapter
dropdownAutoWidth	boolean	false
dropdownCssClass	string	''	Adds additional CSS classes to the dropdown container. The helper :all: can be used to add all CSS classes present on the original <select> element.
dropdownParent	jQuery selector or DOM node	$(document.body)	Allows you to customize placement of the dropdown.
escapeMarkup	callback	Utils.escapeMarkup	Handles automatic escaping of content rendered by custom templates.
language	string or object	EnglishTranslation	Specify the language used for Select2 messages.
matcher	A callback taking search params and the data object.		Handles custom search matching.
maximumInputLength	integer	0	Maximum number of characters that may be provided for a search term.
maximumSelectionLength	integer	0	The maximum number of items that may be selected in a multi-select control. If the value of this option is less than 1, the number of selected items will not be limited.
minimumInputLength	integer	0	Minimum number of characters required to start a search.
minimumResultsForSearch	integer	0	The minimum number of results required to display the search box.
multiple	boolean	false	This option enables multi-select (pillbox) mode. Select2 will automatically map the value of the multiple HTML attribute to this option during initialization.
placeholder	string or object	null	Specifies the placeholder for the control.
resultsAdapter		ResultsAdapter	Used to override the built-in ResultsAdapter.
selectionAdapter		SingleSelection or MultipleSelection, depending on the value of multiple.	Used to override the built-in SelectionAdapter.
selectionCssClass	string	''	Adds additional CSS classes to the selection container. The helper :all: can be used to add all CSS classes present on the original <select> element.
selectOnClose	boolean	false	Implements automatic selection when the dropdown is closed.
sorter	callback
tags	boolean / array of objects	false	Used to enable free text responses.
templateResult	callback		Customizes the way that search results are rendered.
templateSelection	callback		Customizes the way that selections are rendered.
theme	string	default	Allows you to set the theme.
tokenizer	callback		A callback that handles automatic tokenization of free-text entry.
tokenSeparators	array	[]	The list of characters that should be used as token separators.
width	string	resolve	Supports customization of the container width.
scrollAfterSelect	boolean	false	If true, resolves issue for multiselects using closeOnSelect: false that caused the list of results to scroll to the first selection after each select/unselect (see https://github.com/select2/select2/pull/5150). This behaviour was intentional to deal with infinite scroll UI issues (if you need this behavior, set false) but it created an issue with multiselect dropdown boxes of fixed length. This pull request adds a configurable option to toggle between these two desirable behaviours.