Skip to content


Repository files navigation

Cmsplugin Gallery

Run Tests

cmsplugin_gallery is the most versatile gallery plugin for djangoCMS. It supports Python3.7 and above.


  • Latest version of the plugin supports filer.
  • Drag & Drop reordering of photos in the plugin admin
  • Unlimited, auto-discovered custom templates - you can change template of given gallery at anytime, use javascript galleries etc.


Supports Django version 3.2+ and latest Django CMS version. Follow individual installation instructions before installing cmsplugin_gallery. Please note that cmsplugin_gallery requires:


If you are using version later than 1.1.4, Please update all your templates to use image_src instead of src. image_src is the new FilerImageField instead of the old src which was the ImageField. Check this diff for the change in sample template.


  • pip install cmsplugin_gallery
  • Add 'cmsplugin_gallery' to INSTALLED_APPS (if necessary)
  • Run Migrations


The easiest approach is to use a nice feature of cmsplugin_gallery - the template autodiscovery. In order to take advantage of it, add your custom templates in the cmsplugin_gallery subdirectory of any of template dirs scanned by Django.

If you don't want to use the autodiscovery, you can hardcode available templates in using following setting:

    ('app/template.html', 'Template #1', ),
    ('app/other_template.html', 'Template #2', ),

Embed as a typical plugin.

Bugs & Contribution

Please use GitHub to report bugs, feature requests and submit your code.

Report New Issue