MongoEngine User Documentation

MongoEngine is an Object-Document Mapper, written in Python for working with MongoDB. To install it, simply run

$ pip install -U mongoengine
A quick tutorial building a tumblelog to get you up and running with MongoEngine.
User Guide
The Full guide to MongoEngine — from modeling documents to storing files, from querying for data to firing signals and everything between.
API Reference
The complete API documentation — the innards of documents, querysets and fields.
How to upgrade MongoEngine.
Django Support
Using MongoEngine and Django


To get help with using MongoEngine, use the MongoEngine Users mailing list or the ever popular stackoverflow.


Yes please! We are always looking for contributions, additions and improvements.

The source is available on GitHub and contributions are always encouraged. Contributions can be as simple as minor tweaks to this documentation, the website or the core.

To contribute, fork the project on GitHub and send a pull request.


See the Changelog for a full list of changes to MongoEngine and Upgrading for upgrade information.


Always read and test the upgrade documentation before putting updates live in production ;)

Offline Reading

Download the docs in pdf or epub formats for offline reading.

Indices and tables