Cartridge is a shopping cart application built using the Django framework. It is BSD licensed and designed to provide you with a clean and simple base for developing e-commerce websites. It purposely does not include every conceivable feature an e-commerce website could potentially use, instead focusing on providing only the core features that are common to every e-commerce website.

This specific focus stems from the idea that every e-commerce website is different, tailoring to the particular business and products at hand, and should therefore be as easy as possible to customize. Cartridge achieves this goal with a code-base that implements only the core features of an e-commerce site, therefore remaining as simple as possible.

Cartridge extends the Mezzanine content management platform and a live demo of Cartridge can be found by visiting the Mezzanine live demo.


  • Hierarchical categories
  • Easily configurable product options (colours, sizes, etc.)
  • Hooks for shipping calculations and payment gateway
  • Sale pricing
  • Stock management
  • Product popularity
  • Thumbnail generation
  • Built-in test suite
  • Separation of presentation (no embedded markup)
  • Smart categories (by price range, colour, etc)
  • Configurable nunber of checkout steps
  • Denormalised data for accessiblilty and performance


Cartridge is designed as a plugin for the Mezzanine content management platform and us such requires it to be installed. By following the installation instructions below this should occur automatically.


Assuming you have setuptools installed, the easiest method is to install directly from pypi by running the following command, which will also attempt to install the dependencies mentioned above:

$ easy_install -U cartridge

Otherwise you can download Cartridge and install it directly from source:

$ python install

Once installed, the command mezzanine-project should be available via Mezzanine, which can be used for creating a new Cartridge project in a similar fashion to

$ mezzanine-project -a cartridge project_name

You can then run your project with the usual Django steps:

$ cd project_name
$ python syncdb --noinput
$ python runserver

You should then be able to browse to and log in using the default account (username: admin, password: default). If you'd like to specify a different username and password during set up, simply exclude the --noinput option included above when running syncdb.


Cartridge is an open source project that is managed using both Git and Mercurial version control systems. These repositories are hosted on both Github and Bitbucket respectively, so contributing is as easy as forking the project on either of these sites and committing back your enhancements.


For general questions or comments, please join the mezzanine-users mailing list. To report a bug or other type of issue, please use the Github issue tracker.