Python CSS HTML JavaScript Other
Latest commit 872c026 Feb 21, 2017 @solarissmoke solarissmoke committed on GitHub Added to sandbox ALLOWED_HOSTS. Fixes #2212.
Failed to load latest commit information.
.tx Correct path for transifex Apr 10, 2015
docs Add note about adding billing address to user address book to release… Feb 13, 2017
gulpfile.js Remove the demo site Nov 16, 2015
sandbox Added to sandbox ALLOWED_HOSTS. Fixes #2212. Feb 21, 2017
src/oscar Don't return primary_image method Feb 20, 2017
tests Add test for recommended products ordering. Feb 19, 2017
.coveragerc Ignore migrations for coverage reports Apr 12, 2013
.dockerignore Read sandbox cache settings from CACHE_URL Feb 3, 2017
.editorconfig Fix .editorconfig misspell parameter mistake Dec 30, 2016
.gitignore Add __pycache__ to gitignore Feb 4, 2017
.mailmap Update .mailmap for 0.6.1 release Jan 23, 2014
.travis.yml Update travis to run the tests via tox Dec 30, 2016
AUTHORS Update AUTHORS Feb 5, 2017
CHANGELOG.rst Update changelog of really old releases Feb 5, 2017
CONTRIBUTING.rst Convert readthedocs link for their .org -> .io migration for hosted p… May 31, 2016
Dockerfile Fix media files in the docker image Feb 3, 2017
LICENSE Use a year range in the license May 22, 2014 Fix path in MANIFEST file (prepend `src`) Dec 6, 2014
Makefile Load promotions in the sandbox Feb 10, 2017
README.rst Update commercial support paragraph Feb 5, 2017
codecov.yml Add codecov.yml Aug 2, 2016
package.json Implement simple gulp task to generate less files Nov 15, 2015
requirements.txt Update transifex-client from 0.12.3 to 0.12.4 Feb 7, 2017
requirements_migrations.txt Update pymysql from 0.7.9 to 0.7.10 Feb 15, 2017
setup.cfg Rename all tests files from * to test_*.py Feb 7, 2017 Upgrade to latest Webtest. Feb 13, 2017
tox.ini Fix sandbox in tox Feb 5, 2017 Transifex: Don't push translation Oct 23, 2014


Domain-driven e-commerce for Django

Oscar is an e-commerce framework for Django designed for building domain-driven sites. It is structured such that any part of the core functionality can be customised to suit the needs of your project. This allows a wide range of e-commerce requirements to be handled, from large-scale B2C sites to complex B2B sites rich in domain-specific business logic.


Further reading:

Continuous integration status: Coverage Requirements Status

PyPI status:

Docs status:

Documentation Status

Core team:



These are screenshots from the 'sandbox' example site that ships with Oscar. It sports a simple design built with Twitter's Bootstrap and provides a good starting point for rapidly building elegant e-commerce sites.

The sandbox site is also available to browse at Dashboard users can be created using this gateway page.

The sandbox site can be set-up locally in 5 commands. Want to make changes? Check out the contributing guidelines.


The following extensions are stable and ready for use:

The following are community-written extensions:

Let us know if you're writing a new one!


Oscar is released under the permissive New BSD license (see summary).

Case studies

Oscar is still in active development but is used in production by a range of companies, from large multinationals to small, boutique stores. See for an overview.

Many more on the way. If you use Oscar in production, please let us know.

Looking for commercial support?

If you are interested in having an Oscar project built for you, or for development of an existing Oscar site then please get in touch via