django-smuggler 0.4

Import/export fixtures via Django admin interface
django-smuggler is a pluggable application for the Django web framework that help you import/export fixtures via the automatically-generated admin interface.

Installing & Setup

Smuggler is in the Python Package Index (PyPI) and you can easily install the latest stable version of it using the tools pip or easy_install. Try:

pip install django-smuggler


easy_install django-smuggler

Alternatively, you can install Smuggler from source code running the follow command on directory that contains the file

python install

After installation you need configure your project to recognizes the Smuggler application adding 'smuggler' to your INSTALLED_APPS setting and setup the project URLConf like follow:

urlpatterns = patterns('',
 # ...
 (r'^admin/', include('smuggler.urls')), # put it before admin url patterns
 (r'^admin/', include(,

Then try access these urls:

 * /admin/import/, to upload files to be imported;
 * /admin/export/, to download data from whole project;
 * /admin/APP_LABEL/export/, to download data from a app;
 * /admin/APP_LABEL/MODEL_LABEL/export/, to download data from a model;

If you can access the URLs above, the application was setup correctly. Note that these URLs are accessible only by superusers.

Smuggler also provides a template to show buttons for import and export data on change list page (change_list.html). You can setup the ModelAdmin you are interested like follow:

class ExampleAdmin(admin.ModelAdmin):
 change_list_template = 'smuggler/change_list.html'

Note: on directory "etc/sample_templates/" you have some template examples to put Smuggler's buttons on app indexes and admin index page.


Smuggler has the following settings available. You can set them in your If you doesn't set them it will assume the default values:
 Format for exported files. 'json' and 'xml' are supported. Default: 'json'.
 Indentation for exported files. Default: 4.
 To be used with signal smuggler.signals.save_data_on_filesystem. Default: None.

last updated on:
April 3rd, 2013, 18:34 GMT
developed by:
Guilherme Gondim
license type:
GPL v3 
ROOT \ Internet \ Django Plugins


In a hurry? Add it to your Download Basket!

user rating



Rate it!
2 Screenshots
django-smuggler - Buttons on change_list.htmldjango-smuggler - Load form
What's New in This Release:
  • Django 1.5+ support;
  • Added German translation;
  • Added some tests.
read full changelog

Add your review!