django-select2 in Django

Jan. 10, 2019, 2:48 a.m.

It is actual for django-select2 <= 7.7.1

Immediately use django_select2 in the Django admin does not work because django_select2 requires jQuery. By default django_select2 widget does not include jQuery. You can read more about this on Add jquery to widget Django.

To quickly add jQuery to django_select2, do the following:

1. Add django-select2

Install django_select2:

pip install django_select2

Add package in ISTALLED_APPS:


If you use ModelWidgets, add urls:

url(r'^select2/', include('django_select2.urls')),

2. Create own custom widget based on Select2Widget

from django_select2.forms import Select2Widget as BaseSelect2Widget

class Select2Widget(BaseSelect2Widget):
    Added jquery to widget
    def _get_media(self):
        media = super()._get_media()

        css = ['select2/css/select2.css']  # if you want override some styles

        extra = '' if settings.DEBUG else '.min'
        js = [f'admin/js/vendor/jquery/jquery{extra}.js', 'admin/js/jquery.init.js', 'my_app/admin_compat.js']

        return forms.Media(js=js, css={'screen': css})

    media = property(_get_media)
if (window.django !== undefined) var jQuery = django.jQuery, $ = django.jQuery;

3. Use custom widget in your code:

from my_app.widgets import Select2Widget

class MyForm(forms.Form):
   my_choice = forms.ChoiceField(widget=Select2Widget)

Now it should works.

In the second step, the jQuery version was used, which is part of Django. but you can use your version of jQuery. How to do this and other settings, you can read on the page Add jquery to widget Django.

Rate this article

5 from 5 (total 1 rating)

You can send feedback, suggestions or comments on this article using this form:

Fields marked by star ( * ) is required.

Thank you for yor feedback!

After clicking the "Send" button, your message will be delivered to me on the mail.

Author of Article

Artem Maltsev

Web-developer, having the knowlenge of programming language - Python, framework - Django, content management system - Django CMS, platform of e-commerce site - Django Shop and many other applications, using this technologies.

The right to use content on this page

Permission is granted to copy an content with its author and reference to the original without using the parameter rel="nofollow" in tag <a>. Usage:

Author of Article: Artem Maltsev
Link to article: <a href=""></a>

More: Terms of site usage

Comments: 0

You can leave a comment as an unregistered user.

But if you sing up, you can:

  • receive notifications
  • view your comments
  • be able to use all the functions of the developed services

To comment in one's own name you should log in or sign up on Vuspace website


There is no search on this site, so I offer to use usual search engine, for example, Google, adding "vivazzi" after your request.

Try it

Select currency for displaying monetary values