Breaking changes

• The minimum jQuery version supported is the latest version in the 1.x, 2.x, 3.x, and 4.x series (#5525, #5955)
• Removed support for legacy Internet Explorer (versions older than IE 11) (#5834)
• Removed modules deprecated in 4.0.0 (#5815)
  • Removed legacy support for <input /> tags
  • Removed legacy support for initSelection
  • Removed legacy support for query
  • Removed old select2/compat/matcher module
• Removed undocumented CSS-related options (#5815)
  • Removed dropdownCss option
  • Removed adaptDropdownCss option
  • Removed containerCss option
  • Removed adaptContainerCss option
• The containerCssClass option has been renamed to selectionCssClass (#5815, #5847)
• Significant changes to the HTML/CSS for the selection area impacting custom themes (#5842)
• New CSS classes for the dropdown results to better target highlighted / selected results (#5841)
• The search box in the selection area for multiple selects has been changed from an <input /> to a <textarea> to support pasting multiple lines (#5806)
• Change tab key to select the currently highlighted option instead of just closing (#5759)
• Tags will be highlighted first in the results even if other options have been selected (#5812)

New features / improvements

• dropdownCssClass and selectionCssClass are now available in all builds of Select2 (#5815)
• Calls to get the currently selected options are now considerably faster on large datasets (#5775)
• Selected results in the dropdown should now be properly announced to screen readers (#5841)
• Significant improvements were made to make the selection area accessible (#5824, #5842, #5916, #5942, #5973)
• Allow pasting multiple lines into the search field for tokenization (#5806)
• Add support for jQuery 4.0.0 (#6332)
• Add originalEvent to close trigger arguments (#6079)

Bug fixes

• Resize the selection search on close to properly display the placeholder (#5766)
• Change internal data ID generation to be more unique and prevent conflicts with numeric IDs (#5840)
• Internet Explorer 11 no longer steals focus of search box while tagging (#5842)
• Fix slow memory leak caused by not clearing cache on destroy (#5965)
• Fix multiple select placeholder misalignment (#6277)
• Fix RTL selection__choice__remove button (#6257)
• Fix support for data-placeholder values which consist solely of digits (#6297)
• Fix unselection of items from AJAX data sources with non-string identifiers (#6241, #6335)
• Convert optgroup child data identifiers to string datatype (#6338)

Translations

• Add Esperanto translation (eo) (#5823)
• Add Punjabi translations (pa) (#5831)
• Add Telugu translations (te) (#5881)
• Updated Hungarian translations (hu) for 4.1.0 changes (#5970)
• Add Luxembourgish translation (lb) (#6131)
• Add Uyghur (Uighur) translation (ug) (#6166)
• Update Arabic translation with removeItem string (ar) (#6175)
• Add missing Traditional Chinese translations (zh-TW) (#6157)
• Update Indonesian translation (id) (#6153)
• Update Turkish translation (tr) (#6123)
• Update Romanian translation (ro) (#6190)
• Updated DE/ES/FR/PT/PT-BR translations (#6132)
• Update Polish translation (pl) (#6097, #6377)
• Update Norwegian translations (nb) (#6213)
• Update Persian/Farsi translation (fa) (#6258)
• Fix Dutch translation (nl) removing unwanted dots for noResults (#6269)
• Fix Brazilian Portuguese translation typo (#6200)
• Add missing Bosnian, Catalan, Danish, and Finnish translations (#6305)

Miscellaneous

• The amdLanguageBase option no longer has an effect because the full build does not include any dynamically loaded modules (#5815)
• Replace jQuery attr/removeAttr with native getAttribute/setAttribute/removeAttribute (#6227, #6228)
• Replace jQuery addClass with native classList.add (#6229)
• Remove jQuery from Utils and Translation modules (#6233)
• Remove use of jQuery prop() function (#6289)
• Switch NPM publishing to trusted publishing with provenance (#6405)

This release was sponsored in part by a donation from Bullet Train and many other contributors on the Open Source Collective and GitHub Sponsors.

Breaking changes

• The minimum jQuery version supported is the latest version in the 1.x, 2.x, and 3.x series (#5955)
• The search box in the selection area for multiple selects has been changed from an <input /> to a <textarea> to support pasting multiple lines (#5806)
• Change tab key to select the currently highlighted option instead of just closing (#5759)
• Tags will be highlighted first in the results even if other options have been selected (#5812)

New features / improvements

• Significant improvements were made to make the selection area accessible (#5824, #5916, #5942, #5973)
• Allow pasting multiple lines into the search field for tokenization (#5806)

Bug fixes

• Fix slow memory leak caused by not clearing cache on destroy (#5965)

Translations

• Add Telugu translations (te) (#5881)
• Updated Hungarian translations (hu) for 4.1.0 changes (#5970)

Breaking changes

• The selectionCssClass option now works when used without containerCssClass (#5815, #5847)
• Significant changes to the HTML/CSS for the selection area impacting custom themes (#5842)
• New CSS classes for the dropdown results to better target highlighted / selected results (#5841)

New features / improvements

• The autocomplete attribute is now copied over to the Select2 search field (#5839)
• Selected results in the dropdown should now be properly announced to screen readers (#5841)
• Significant improvements were made to make the selection area accessible (#5842)

Bug fixes

• Resize the selection search on close to properly display the placeholder (#5766)
• Change internal data ID generation to be more unique and prevent conflicts with numeric IDs (#5840)
• Internet Explorer 11 no longer steals focus of search box while tagging (#5842)

Select2 is a looking for sponsors to keep development active. Interested in seeing Select2 continue to be developed? Sponsor @kevin-brown (and by extension, Select2) on GitHub Sponsors or sponsor Select2 on Open Collective!

Breaking changes

• The minimum jQuery version supported is the latest version in the 1.x, 2.x, and 3.x series (#5225)
• Removed support for legacy Internet Explorer (versions older than IE 11) (#5834)
• Removed modules deprecated in 4.0.0 (#5815)
  • Removed legacy support for <input /> tags
  • Removed legacy support for initSelection
  • Removed legacy support for query
  • Removed old select2/compat/matcher module
• Removed undocumented CSS-related options (#5815)
  • Removed dropdownCss option
  • Removed adaptDropdownCss option
  • Removed containerCss option
  • Removed adaptContainerCss option
• The containerCssClass option has been renamed to selectionCssClass (#5815)

New features / improvements

• dropdownCssClass and selectionCssClass are now available in all builds of Select2 (#5815)
• Calls to get the currently selected options are now considerably faster on large datasets (#5775)

Translations

• Add Esperanto translation (eo) (#5823)
• Add Punjabi translations (pa) (#5831)

Miscellaneous

• The amdLanguageBase option no longer has an effect because the full build does not include any dynamically loaded modules (#5815)

Select2 is a looking for sponsors to keep development active. Interested in seeing Select2 continue to be developed? Sponsor @kevin-brown (and by extension, Select2) on GitHub Sponsors or sponsor Select2 on Open Collective!

New features / improvements

• Trigger input event before change events (#4649)
• Feed back the keypress code that was responsible for the 'close' event (#5513)
• Only trigger selection:update once on DOM change events (#5734)

Bug fixes

• Prevent opening of disabled elements (#5751)

Documentation

• Fix "edit this page" links in docs (#5689)

Miscellaneous

• Registered Select2 on Open Collective (#5700, #5721, #5741)

Select2 is a looking for sponsors to keep development active. Interested in seeing Select2 continue to be developed? Sponsor @kevin-brown (and by extension, Select2) on GitHub Sponsors or sponsor Select2 on Open Collective!

Bug fixes

• Fixes incorrect offset when using the Shadow DOM and styling the <html> element (#5682)

Miscellaneous

• Replace cdnjs with jsDelivr in the documentation (#5687)
• Fix incorrect provider for the automated NPM deployment (#5686)

Select2 is a looking for sponsors to keep development active. Interested in seeing Select2 continue to be developed? Sponsor @kevin-brown (and by extension, Select2) on GitHub Sponsors!

Bug fixes

• Fixes jQuery migrate error when getting offset when dropdownParent not in document (#5584)

Miscellaneous

• Enable GitHub actions for CI (#5591)
• Documentation has been moved into and is deployed from the code repository (#5638)
• Remove Travis CI integration (#5665)

New features / improvements

• Support passing in a selector for dropdownParent option (#5622)

Bug fixes

• Fix bug where dropdowns pointing upwards were incorrectly positioned (#5621)

New features / improvements

• Mirror disabled state through aria-disabled on selection (#5579)
• Select2 now clears the internal ID when it is destroyed (#5587)
• Set the main ARIA 1.1 roles and properties for comboboxes (#5582)
• The language option now has a clearly defined fallback chain (#5602)

Bug fixes

• Do not propagate click when search box is not empty (#5580)
• Fix maximumSelectionLength being ignored by closeOnSelect (#5581)
• Fix generated options not receiving result IDs (#5586)
• Remove selection title attribute if text is empty (#5589)
• Reposition dropdown whenever items are selected (#5590)
• Fix dropdown positioning when displayed above with messages (#5592)
• Fix search box expanding width of container (#5595)
• allowClear no longer shifts selections to a new line (#5603)

Translations

• Fix error in German translations (#5604)

Miscellaneous

• Updated development grunt version so it no longer shows as vulnerable (#5597)
• Remove unused variables (#5554)

New features / improvements

• Test against and fix compatibility with jQuery 3.4.1 (#5531)
• Results respect disabled state of <option> (#5560)
• Add computedstyle option for calculating the width (#5559)

Bug fixes

• Fix tag creation being broken in 4.0.7 (#5558)
• Fix infinite scroll when the scrollbar is not visible (#5575)
• Revert change to focusing behaviour in 4.0.6 (#5576)

Translations

• Fix wording in French translations (#5521)

Miscellaneous

• Update grunt-contrib-qunit to latest version (#5530)
• Removed unused .select2-selection__placeholder CSS definitions for multiple selects (#5508)
• Remove deprecated jQuery shorthand (#5564)