Domain-driven e-commerce for Django
Python CSS HTML JavaScript Other
Latest commit b161403 Nov 23, 2016 @maikhoepfel maikhoepfel committed on GitHub Merge pull request #2177 from django-oscar/maikhoepfel-patch-1
Explicit pip caching not needed on Travis any more
Failed to load latest commit information.
.tx Correct path for transifex Apr 10, 2015
docs Updated code for Django>=1.8 Nov 19, 2016
gulpfile.js Remove the demo site Nov 16, 2015
sites Fix template directories for the sandbox site. Oct 2, 2016
src/oscar Merge pull request #2003 from Southern-Exposure-Seed-Exchange/master Nov 7, 2016
tests Merge pull request #2009 from john-parton/issue/2008/expirymonth_attr… Nov 7, 2016
.coveragerc Ignore migrations for coverage reports Apr 12, 2013
.dockerignore Create simple dockerfile to run the sandbox Nov 22, 2015
.editorconfig sandbox: Add docker-compose file Jul 30, 2016
.gitignore Implement simple gulp task to generate less files Nov 15, 2015
.mailmap Update .mailmap for 0.6.1 release Jan 23, 2014
.travis.yml Explicit pip caching not needed on Travis any more Nov 23, 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 Fix the `make lint` command. Jul 31, 2016 Show warning message if there is more than one product stock record h… Nov 5, 2016
tox.ini Fix the `make lint` command. Jul 31, 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