Domain-driven e-commerce for Django
Clone or download
Latest commit f19545e Sep 13, 2018
Failed to load latest commit information.
.github Add Github contributor guidelines and issue templates. May 28, 2018
.tx Update translations from Transifex. May 23, 2018
docs Add missing Decimal import to code block in documentation (#2820) Sep 10, 2018
gulpfile.js Upgrade several gulp and less npm packages for security issues in the… May 22, 2018
sandbox Fix debug error URLs whose handlers now require an exception. Aug 21, 2018
src/oscar Improve explanation for why you cannot add a variant, when a product … Sep 10, 2018
tests Fix form errors when going back to first step in dashboard OfferWizard ( Sep 10, 2018
.coveragerc Exclude test utils from coverage reports. (#2538) Dec 29, 2017
.dockerignore Read sandbox cache settings from CACHE_URL Feb 3, 2017
.editorconfig Fix .editorconfig misspell parameter mistake Dec 30, 2016
.eslintrc.json Add eslint checks to all Oscar JS to the travis build. Apr 14, 2018
.gitignore Add a line for the /.pytest_cache/ directory into the .gitignore file May 29, 2018
.mailmap Update .mailmap for 0.6.1 release Jan 23, 2014
.travis.yml Add compatibility for Django 2.1, and drop support for Python 3.4. Jun 20, 2018
AUTHORS Update AUTHORS and core team list in readme. May 23, 2018
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 the docker image (duplicate psycopg2 requirement) Apr 18, 2017
LICENSE Make license perpetual Jun 14, 2018 Fix path in MANIFEST file (prepend `src`) Dec 6, 2014
Makefile Update sandbox creation May 24, 2018
README.rst Add django-oscar-invoices to the extensions list. Aug 25, 2018
codecov.yml Add codecov.yml Aug 2, 2016
package-lock.json Upgrade several gulp and less npm packages for security issues in the… May 22, 2018
package.json Upgrade several gulp and less npm packages for security issues in the… May 22, 2018
requirements.txt Merge pull request #2826 from django-oscar/pyup-update-whitenoise-4.0… Sep 13, 2018
requirements_migrations.txt Update pymysql from 0.9.0 to 0.9.2 Jul 4, 2018
setup.cfg Reduce maximum line length in flake8 config to 119 characters. Jun 20, 2018 Merge pull request #2752 from solarissmoke/feature/django22 Jun 26, 2018
tox.ini Forward-port release notes for 1.6.3 and update Django 2 dependency i… Aug 3, 2018 Drop transifex-client from requirements. Feb 28, 2018


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!


Videos with talks about Oscar:


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