Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Failed to load latest commit information.
docs updated docs
example fixed py32,33 issues
.coveragerc added python 2.6, 2.7, 3.2, 3.3, 3.3, pypy and pypy3 tests
.gitignore added more test coverage
.travis.yml disabling a few unsupported configurations fixed packageing
README.rst updated docs
pytest.ini replaced nose with pytest
requirements.txt added more test coverage
requirements_test.txt added support for django 1.4-1.7 and python 2.6-3.4
setup.cfg fixed tox added python 2.6, 2.7, 3.2, 3.3, 3.3, pypy and pypy3 tests
tox.ini trying to fix coveralls again, apparently the documented syntax in to…



Django Tags Input is a module that gives you a modified version of the Xoxco jQuery Tags Input library within Django.

The result is a very pretty interface with tags and autocomplete which can optionally automatically create new items when they are missing.

One of the most useful features of Django Tags Input is that it stores the elements in the order which you input.

So if you insert B, A, C into the database, it will return it sorted the way you entered it: B, A, C.


How to install

Installing this module only takes a couple of minutes.

Currently Django 1.4, Django 1.5, Django 1.6 and Django 1.7 are support in combination with Python 2.6 and 2.7. Python 3.2, 3.3 and 3.4. Pypy and Pypy3.

  1. Install the module itself

    pip install django-tags-input

    # or

    easy_install django-tags-input

  2. Add tags_input to your INSTALLED_APPS setting in the Django


        # ... your other installed apps
  3. Add the mappings to your file:


        'some_app.SomeKeyword': {
            'field': 'some_field',
        'some_app.SomeOtherKeyword': {
            'fields': ('some_field', 'some_other_field'),
        'some_app.SomeSortedKeyword': {
            'field': 'some_field',
            'ordering': [
            'filters': {
                'some_field__istartswith': 'a',
            'excludes': {
                'some_field__iexact': 'foobar',
        'some_app.SomeCreateableKeyword': {
            'field': 'some_field',
            'create_missing': True,
  4. Add the tags_input urls to your


    from django.conf import urls
    urlpatterns = patterns('',
        url(r'^tags_input/', include('tags_input.urls', namespace='tags_input')),
        # ... other urls ...

Admin usage

from django.contrib import admin
import models
from tags_input import admin as tags_input_admin

class YourAdmin(tags_input_admin.TagsInputAdmin):
    pass, YourAdmin)


To test the project simply clone the repository, install and run the example:

mkvirtualenv django-tags-input git clone pip install -e django-tags-input cd django-tags-input/example python runserver

Now you can go to http://localhost:8000/admin/ and login with username and password admin and admin respectively.

After this you can try adding some extra Foo objects through the Spam admin here: http://localhost:8000/admin/autocompletionexample/spam/2/

Note that some parts of the example are deliberately broken to test the behaviour in broken environments.

Something went wrong with that request. Please try again.