skip to navigation
skip to content

wagtailmodelchooser 0.2.0

Wagtail chooser panel generator for generic Django models


Wagtail chooser panel generator for generic Django models.

It elegantly completes wagtail.contrib.modeladmin and allows a simple selection of any model instance anywhere in the Wagtail admin.


  • Python (2.7, 3.4, 3.5)
  • Django (1.8, 1.9, 1.10)
  • Wagtail (1.5, 1.6)


Install using pip.

$ pip install wagtailmodelchooser


The most simple usecase, without any customization.

from wagtailmodelchooser.edit_handlers import register_chooser_for_model

ItemChooserPanel = register_chooser_for_model(Item)

For more advanced examples, please refer to the documentation.


Install testing requirements.

$ pip install -r requirements.txt

Run with runtests.

$ ./

You can also use the excellent tox testing tool to run the tests against all supported versions of Python and Django. Install tox globally, and then simply run:

$ tox


To build the documentation, you’ll need to install mkdocs.

$ pip install mkdocs

To preview the documentation:

$ mkdocs serve
Running at:

To build the documentation:

$ mkdocs build
File Type Py Version Uploaded on Size
wagtailmodelchooser-0.2.0-py2.py3-none-any.whl (md5) Python Wheel 2.7 2016-08-17 27KB
wagtailmodelchooser-0.2.0.tar.gz (md5) Source 2016-08-17 9KB