NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1050 most downloaded on Packagist
JavaScript Autocomplete functionality for Symfony
Latest stable
v3.7.2
Last release 14 days ago
08 Nov 2026
Ships fairly regularly
a new release about every 6 weeks
Some releases are documented
notes for 32 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
66 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
bug #4236 Keep the selected value of a field moved in the page (@Kocal)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v3.7.1...v3.7.2)
minor #4211 Translate 'Add placeholder' to Spanish (@estdiesai)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v3.7.0...v3.7.1)
feature #4126 Exclude already selected options from remote results (@anthovallet)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Changelog (https://github.com/symfony/ux-autocomplete/compare/v3.6.0...v3.7.0)
preferred_choices option in Ajax-powered fields (@Kocal).gitignore, and ignore the .vitest/ report directory (@Kocal)preferred_choices option in Ajax-powered fields: the preferred choices are listed firstminor #4086 Update the tooling dependencies (@Kocal)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v3.5.0...v3.6.0)
symfony/asset-mapper 8.2 and later (@Kocal)Nothing published for this version
feature #3814 Add support for Twig 4.x (@Kocal)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v3.4.0...v3.5.0)
target to es2022 (@Kocal)AssetMapperBundleoptgroup labels returned by the AJAX endpoint, so group_by can use translation keysEntityAutocompleterInterface::getTranslationDomain() to choose the translation domain used for the optgroup labelsAutocompleterInterface, OptionsAwareAutocompleterInterface, AutocompleteChoiceType and #[AsAutocompleteField] so any data source can back an autocomplete field. The Doctrine ORM API stays fully supportedux_autocomplete route, served by AutocompleteController. The ux_entity_autocomplete route alias is deprecatedmax_options option to control how many options the dropdown displays at onceminor #3735 Add sync-packages.php to normalize packages .gitattributes (@Kocal)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v3.3.0...v3.4.0)
bug #3685 Fix LIKE ESCAPE clause breaking search on PostgreSQL (@Amoifr)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v3.2.0...v3.3.0)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v3.1.0...v3.2.0) * no significant changes
Changelog (https://github.com/symfony/ux-autocomplete/compare/v3.1.0...v3.2.0)
security #cve-2026-49216 Fix XSS via unescaped AJAX response data (@Kocal)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v3.0.0...v3.1.0)
hash_equals() to compare the extra_options checksum (@Amoifr)hash_equals() to compare the extra_options checksum to prevent timing attacksfeature #3103 Remove deprecated code for 3.0 (@smnandre)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v2.34.0...v3.0.0)
clear_on_focus (@zairigimad)ParentEntityAutocompleteType in favor of BaseEntityAutocompleteTypeExtraLazyChoiceLoader in favor of Symfony\Component\Form\ChoiceList\Loader\LazyChoiceLoader from Symfony Form >=7.2$security to AutocompleteResultsExecutor::__construct()EntityAutocompleterInterface::getAttributes() and EntityAutocompleterInterface::getGroupBy()bug #3685 Fix LIKE ESCAPE clause breaking search on PostgreSQL (@Amoifr)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v2.36.1...v2.36.2)
ESCAPE '\' clause introduced in 2.36; a backslash-free LIKE escape character is now used.security #cve-2026-49216 Fix XSS via unescaped AJAX response data (@Kocal)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v2.35.0...v2.36.0)
Escape LIKE wildcards (% and _) in the autocomplete search query so user
input can no longer alter the matching behavior of the generated SQL query.
Fix XSS vulnerability where data returned from AJAX endpoints was rendered without HTML escaping.
Values from the text field of AJAX responses are now escaped by default.
Possible BC break: if your endpoint legitimately returns HTML in the text field (e.g., for rich content), opt in via the options_as_html option:
#[AsEntityAutocompleteField]
class IngredientAutocompleteType extends AbstractType
{
public function configureOptions(OptionsResolver $resolver): void
{
$resolver->setDefaults([
'class' => Ingredient::class,
+ 'options_as_html' => true,
]);
}
}
feature #3422 Add option clear_on_focus (@zairigimad)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v2.34.0...v2.35.0)
clear_on_focus (@zairigimad)reset_on_focus option to clear and reload options when the autocomplete field regains focusbug #3401 Update package.json to 2.33.0 (@Kocal)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v2.33.0...v2.34.0)
2.33.0 (@Kocal)feature #3362 Migrate from tsup (deprecated) to tsdown (@Kocal)
Changelog (https://github.com/symfony/ux-autocomplete/compare/v2.32.0...v2.33.0)
Extension from DependencyInjection instead of HttpKernel (@Kocal)repository issue (@Kocal)Nothing published for this version
Nothing published for this version
Ensure compatibility with PHP 8.5
Nothing published for this version
Nothing published for this version
- Add Symfony 8 support
Nothing published for this version
Nothing published for this version
Default plugins like clear_button or remove_button can now be removed when setting their value to false in the tom_select_options.plugins option, for
clear_button or remove_button can now be removed when setting their value to false in the tom_select_options.plugins option, for example:<?php
#[AsEntityAutocompleteField]
class IngredientAutocompleteType extends AbstractType
{
public function configureOptions(OptionsResolver $resolver): void
{
$resolver->setDefaults([
'class' => Ingredient::class,
'tom_select_options' => [
'plugins' => [
'clear_button' => false, // Disable the clear button
'remove_button' => false, // Disable the remove button
],
],
]);
}
public function getParent(): string
{
return BaseEntityAutocompleteType::class;
}
}
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Escape querySelector dynamic selector with CSS.escape() #2663
querySelector dynamic selector with CSS.escape() #2663Nothing published for this version
Deprecate ExtraLazyChoiceLoader in favor of Symfony\Component\Form\ChoiceList\Loader\LazyChoiceLoader
ExtraLazyChoiceLoader in favor of Symfony\Component\Form\ChoiceList\Loader\LazyChoiceLoaderEntityAutocompleterInterface::getAttributes() method to define additional attributes for autocomplete results #2541Nothing published for this version
Take labelField TomSelect option into account #2382
labelField TomSelect option into account #2382Translate the option_create option from TomSelect with remote data setup #2279
option_create option from TomSelect with remote data setup #2279Translate the option_create option from TomSelect #2108
option_create option from TomSelect #2108Nothing published for this version
Nothing published for this version
Nothing published for this version
Allow choice_value option in entity autocomplete fields #1723
choice_value option in entity autocomplete fields #1723Missing translations added for many languages #1527 #1528 #1535
Add doctrine/orm 3 support #1468
Nothing published for this version
Fixed behavior of Autocomplete when the underlying select or option elements were modified to hopefully, more reliably, reset the autocomplete instanc
select or option
elements were modified to hopefully, more reliably, reset the autocomplete
instance. This is particularly important with LiveComponents.render.loading_more Tom Select Virtual Scroll option (loading_more_text)tom-select/dist/css/tom-select.bootstrap4.css to autoimport - this
will cause this to appear in your controllers.json file by default, but disabled
see.extra_options key in an array passed as a 3rd argument of the ->add() method.
It will be used during the Ajax call to fetch results.Nothing published for this version
Revert "Change JavaScript package to type: module"
type: module"Nothing published for this version
Add new BaseEntityAutocompleteType
type: moduleNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add support for symfony/asset-mapper
Nothing published for this version
The autocomplete now watches for update to any option elements inside of it change, including the empty / placeholder element. Additionally, if the se
The autocomplete now watches for update to any option elements inside of
it change, including the empty / placeholder element. Additionally, if the
select or input element's disabled attribute changes, the autocomplete
instance will update accordingly. This makes Autocomplete work correctly inside
of a LiveComponent. This functionality does not work for multiple selects.
Added support for using OptionGroups.
Nothing published for this version
Add assets/src to .gitattributes to exclude them from the installation
Add assets/src to .gitattributes to exclude them from the installation
Fix minCharacters option default value handling when using a falsy value like 0.
Fix TypeScript types
Add a new route parameter to AsEntityAutocompleteField, which allows to choose another route for Ajax calls.
Fix minCharacters option default value handling when using a falsy value like 0.
Fix TypeScript types
Add a way to detect if a field is an "autocomplete" field in form themes - #608
One column per quarter.