Skip to content
JavaScript Python Perl Shell PHP
Find file
Latest commit d7a769a Jul 12, 2013 @mlavin mlavin Merge pull request #16 from Capstrat/master
possible fix for "stacking" of django-file-picker buttons when applied to multiple wymeditor instances.
Failed to load latest commit information.
docs added setup page and removed simple widget Mar 28, 2011
LICENSE.txt update README Jan 23, 2011
README.rst added link to read the docs in the readme Apr 4, 2011 updated hp to read the docs Apr 4, 2011



django-file-picker is a pluggable Django application used for uploading, browsing, and inserting various forms of media into HTML form fields.

Using jQuery Tools, file_picker integrates seamlessly into pre-existing pages by installing an overlay that lists file details and, when applicable, image thumbnails. New files can also be uploaded from within the overlay (via AJAX Upload).

file_picker provides a few optional extensions to help get started, including file_picker.uploads, an app with pre-built Image and File models, and file_picker.wymeditor, an app that integrates with WYMeditor, a web-based WYSIWYM (What You See Is What You Mean) XHTML editor. These extensions are provided for convenience and can easily be replaced by custom modules.

For complete documentation checkout,




  • django-staticfiles

  • WYMeditor 0.5

    If you are using django-staticfiles (or django.contrib.staticfiles in Django 1.3) then add file_picker to your INSTALLED_APPS to include the related css/js.

    Otherwise make sure to include the contents of the static folder in your projects media folder.

Basic Installation

  1. Add file_picker to INSTALLED_APPS in

        'file_picker.uploads', # file and image Django app
        'file_picker.wymeditor', # optional WYMeditor plugin

    file_picker.uploads will automatically create two pickers name 'images' and 'files'.

  2. Add the file_picker URLs to, e.g.:

    import file_picker
    urlpatterns = patterns('',
        # ...
        (r'^file-picker/', include(,
        # ...

Development sponsored by Caktus Consulting Group, LLC..

Something went wrong with that request. Please try again.