Skip to content


Subversion checkout URL

You can clone with
Download ZIP
jQuery UI-powered auto-complete fields for ForeignKey, ManyToMany and text fields
Python JavaScript HTML Makefile CSS Shell
Pull request Compare This branch is 248 commits ahead of sjrd:master.
Latest commit 63e5849 @crucialfelix fix #142 - Inline forms raise TypeError when not filled in
The field is still raising a ValidationError if the field is required,
even though the inline should not be inserting.

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

Build Status PyPI version




Quick Usage

Define a lookup channel:

# yourapp/
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>" %

Add field to a form:

# yourapp/
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

  • //
  • //
  • //


  • Django >=1.5, <=1.9
  • Python >=2.7, <=3.4


Many thanks to all contributors and pull requesters !


Dual licensed under the MIT and GPL licenses:

Something went wrong with that request. Please try again.