Domain-driven e-commerce for Django
Python CSS HTML JavaScript Other
Latest commit 576f6b5 Jan 7, 2017 @tobiase tobiase committed with mvantellingen Remove duplicate option
Failed to load latest commit information.
.tx Correct path for transifex Apr 10, 2015
docs Create release notes Dec 30, 2016
gulpfile.js Remove the demo site Nov 16, 2015
sites Remove duplicate option Jan 8, 2017
src/oscar Merge pull request #2113 from zbmott/master Dec 30, 2016
tests Merge pull request #2113 from zbmott/master Dec 30, 2016
.coveragerc Ignore migrations for coverage reports Apr 12, 2013
.dockerignore Create simple dockerfile to run the sandbox Nov 22, 2015
.editorconfig Fix .editorconfig misspell parameter mistake Dec 30, 2016
.gitignore Update travis to run the tests via tox Dec 30, 2016
.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 file Aug 2, 2016
CHANGELOG.rst Update links to Oscar repo Nov 7, 2014
CONTRIBUTING.rst Convert readthedocs link for their .org -> .io migration for hosted p… May 31, 2016
Dockerfile Add raven to docker images Jul 30, 2016
LICENSE Use a year range in the license May 22, 2014 Fix path in MANIFEST file (prepend `src`) Dec 6, 2014
Makefile Clean up thumbnails at the end of sandbox site build. Aug 2, 2016
README.rst Update Tangent contacts for commercial support. Nov 7, 2016
codecov.yml Add codecov.yml Aug 2, 2016
docker-compose.yml sandbox: Add docker-compose file Jul 30, 2016
package.json Implement simple gulp task to generate less files Nov 15, 2015
requirements.txt Upgrade pycountry in pip dependencies. Nov 5, 2016
requirements_migrations.txt Resurrect requirements_vagrant.txt as requirements_migrations.txt Oct 8, 2014 Alter the script to just call py.test (keep it simple) Jul 13, 2016
sandbox.yml Create simple dockerfile to run the sandbox Nov 22, 2015
setup.cfg flake8 Dec 30, 2016 Update treebeard to latest version Dec 30, 2016
tox.ini Update travis to run the tests via tox Dec 30, 2016 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:

Selected Tangent projects:


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, Tangent can help. Please get in touch via