Skip to main content

E-Commerce Platform

Project description PyPI Known Vulnerabilities


Shuup is an Open Source E-Commerce Platform based on Django and Python.


Contributor License Agreement is required for any contribution to this project. Agreement is signed as a part of pull request process. See the CLA.rst file distributed with Shuup.


Shuup is published under Open Software License version 3.0 (OSL-3.0). See the LICENSE file distributed with Shuup.

Some external libraries and contributions bundled with Shuup may be published under other compatible licenses. For these, please refer to file in the source code tree or the licenses included within each package.


We have a Gitter chat room for Shuup. Come chat with us! Join chat

Docker quick start

Fastest way to get Shuup up and running is to use Docker.

  1. Run:

    docker-compose up
  2. Open localhost:8000/sa in a browser, log in with username: admin password: admin

Full Shuup installation guide

See Getting Started.

For simple project example see our Django-project template.

Getting Started with Shuup development

See Getting Started with Shuup Development.

Contributing to Shuup

Interested in contributing to Shuup? Please see our Contribution Guide.


Shuup documentation is available online at Read the Docs.

Documentation is built with Sphinx.

Issue the following commands to build the documentation:

pip install -r requirements-doc.txt
cd doc && make html

To update the API documentation rst files, e.g. after adding new modules, use command:



  • Per object placeholders. Option to add content per contact group, category, product and CMS page. #1220 :white_check_mark:.
  • Pricing cache. To improve the performance issues with complex catalog campaigns. #1163 :white_check_mark:.
  • Improve shop product purchasable attribute. #1281 :white_check_mark:.
  • Option for ‘centrally’ or ‘separately’ managed products. #1275.
  • Improve product stock behavior. #1249.
  • Improved unit tests for the multishop feature. #1160.
  • Improve order status and order status history. #1211.
  • Initial support for Django 2.0. #1289 :white_check_mark:.
  • OS Admin design/UX overhaul.
  • Various smaller issues from the issues-list.

OS Addons

The purpose of these addons, is to demonstrate how to build other simple addons to extend Shuup. To learn more, here are some useful links about how to extend Shuup.

Admin Preview

doc/_static/admin_shop_product.png doc/_static/admin_order_detail.png

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for shuup, version 2.2.9
Filename, size File type Python version Upload date Hashes
Filename, size shuup-2.2.9-py2.py3-none-any.whl (32.2 MB) File type Wheel Python version py2.py3 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page