Skip to main content

DjangoCMS image gallery plugin with drag&drop reordering in admin, support for thumbnails and jQueryTOOLS overlay.

Project description

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



2.0.3 / 2022-04-20

  • fix: issue with the file not included in file

2.0.0 / 2022-04-20

  • feat: add make file for release automation and generate python3 wheels only
  • correct readme
  • fix: correct metadata
  • feat:add more metadata to the and add a setup.cfg too
  • feat: update ci setup
  • feat: set default auto field
  • feat: get package building for python 3.10 too
  • feat: python3+ only
  • fix: upgrade deps and also add more settins
  • feat: try updated package for djangocms-helper
  • fix: upgrade to a newer version of djangocms-helper
  • feat: add github actions
  • feat: make python code python3.7+
  • fix: make code django 3.2+ compatible
  • Merge pull request #50 from centralniak/fix/failing-migration-tofiler
  • wrap migration in try except
  • bump version
  • fix yet another typo
  • make it backward compatible
  • add module name in settings name
  • bump version
  • fix typo
  • add configurable module name

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cmsplugin_gallery-2.0.3.tar.gz (13.3 kB view hashes)

Uploaded Source

Built Distribution

cmsplugin_gallery-2.0.3-py3-none-any.whl (19.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page