Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A simple live support chat app for django
Python JavaScript CSS
Branch: master
Pull request Compare This branch is 3 commits behind MegaMark16:master.



A live support chat app for django that lets you chat with visitors to your site through the Django Admin interface.


  • django (tested with 1.3)
  • simplejson (required if using python 2.5, suggested otherwise)

Getting Started

To get started simply install using pip:

pip install django-live-support

Add live_support to your installed apps and syncdb (or migrate, if you have south installed).

Your installed apps should look something like this:


Add live_support.urls to your, like so:

from django.conf.urls.defaults import patterns, include, url

from django.contrib import admin

urlpatterns = patterns('',
    url(r'^admin/', include(,
    url(r'^support/', include('live_support.urls')),

If you are going to use the chat_iframe templatetag, be sure that you have 'django.core.context_processors.request' in your TEMPLATE_CONTEXT_PROCESSORS.


You can either override the template for the start_chat (live_support/start_chat.html) and client_chat (live_support/live_support.html) views and just point users to the root of the live_support app as defined in your file, or you can drop the {% chat_iframe %} templatetag into your base template, but be sure to include {% load live_support_tags %} at the top of your template, which will render the chat sidebar (which pops out into a chat window) on every page.

Something went wrong with that request. Please try again.