Skip to main content

Django jQuery Tags Input is a Django field and widget wrapper that adds an easy to use interface for `ManyToManyField` and `ForeignKey` fields in the forms of autocompleting tags with optionally live creation of new linked items

Project description


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 2.2, 3.1 and 3.2 are supported and tested in combination with Python 3.7, 3.8, 3.9 and 3.10.

For Django below 2.2 and Python 2.7 up to version 4.6.0 should work.

For Django 1.4, Django 1.5, Django 1.6 and Django 1.7 in combination with Python 2.6 and 2.7. Python 3.2, 3.3 and 3.4. Pypy and Pypy3 version 2.1.0 can be used.

  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):

    #Optionally specify which ManyToMany fields are to be used for tagging
    #Or define a get_tag_fields() method
    tag_fields = ["some_field"], YourAdmin)


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

# mkvirtualenv is part of virtualenvwrapper, using a regular virtualenv, pyvenv or pipenv is also possible
# Or even without any type of virtualenv at all
mkvirtualenv django-tags-input
git clone
# Tested with Django 3.0
pip install django
pip install -e 'django-tags-input[tests]'
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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-tags-input, version 5.1.0
Filename, size File type Python version Upload date Hashes
Filename, size django_tags_input-5.1.0-py2.py3-none-any.whl (119.1 kB) File type Wheel Python version 3.8 Upload date Hashes View
Filename, size django-tags-input-5.1.0.tar.gz (117.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page