Welcome to django-autocomplete-light’s documentation!


django-autocomplete-light’s purpose is to enable autocompletes quickly and properly in a django project: it is the fruit of years of R&D. It was designed for Django so that every part overridable or reusable independently. It is stable, tested, documented and fully supported: it tries to be a good neighbour in Django ecosystem.


Features include:

  • charfield, foreign key, many to many autocomplete widgets,
  • generic foreign key, generic many to many autocomplete widgets,
  • remote API backed-autocompletes,
  • django template engine support for autocompletes, enabling you to include images etc ...
  • 100% overridable HTML, CSS, Python and Javascript: there is no variable hidden far down in the scope anywhere.
  • add-another popup supported outside the admin too.

Each feature has a live example and is fully documented. It is also designed and documented so that you create your own awesome features too.


This package is released under the MIT License which is similar to the BSD license, you can find a copy in the LICENSE file.

However, I would like to ask that you vote for it on djangopackages.com. The rationnale of my request is simple: the more users, the more contributions and the better this app will be.

Donations are welcome too.


You can run test projects for a local demo in a temporary virtualenv.


Run pip install -U django-autocomplete-light. Check the CHANGELOG for BC (Backward Compatibility) breaks. There should be none for minor version upgrades ie. from 1.1.3 to 1.1.22.

Indices and tables