Options

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	`null`	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.