jQuery UI-powered auto-complete fields for ForeignKey, ManyToMany and text fields
Python JavaScript HTML Makefile CSS Shell
Pull request Compare This branch is 330 commits ahead of sjrd:master.
Latest commit fb87d89 Oct 7, 2017 @crucialfelix crucialfelix Merge pull request #218 from sociossports/import-json-encoder
Override JSONEncoder via settings


Edit ForeignKey, ManyToManyField and CharField in Django Admin using jQuery UI AutoComplete.

Build Status PyPI version





Quick Usage

Define a lookup channel:

# yourapp/lookups.py
from ajax_select import register, LookupChannel
from .models import Tag

class TagsLookup(LookupChannel):

    model = Tag

    def get_query(self, q, request):
        return self.model.objects.filter(name__icontains=q).order_by('name')[:50]

    def format_item_display(self, item):
        return u"<span class='tag'>%s</span>" % item.name

Add field to a form:

# yourapp/forms.py
from ajax_select.fields import AutoCompleteSelectMultipleField

class DocumentForm(ModelForm):

    class Meta:
        model = Document

    tags = AutoCompleteSelectMultipleField('tags')

Fully customizable

  • Customize search query
  • Query other resources besides Django ORM
  • Format results with HTML
  • Customize styling
  • Customize security policy
  • Add additional custom UI alongside widget
  • Integrate with other UI elements elsewhere on the page using the javascript API
  • Works in Admin as well as in normal views

Assets included by default

  • //ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js
  • //code.jquery.com/ui/1.10.3/jquery-ui.js
  • //code.jquery.com/ui/1.10.3/themes/smoothness/jquery-ui.css


  • Django >=1.6, <=1.10
  • Python >=2.7, 3.3-3.5


Many thanks to all contributors and pull requesters !



Dual licensed under the MIT and GPL licenses: