Awesome Open Source
Awesome Open Source

.. image:: :target: .. image:: :target: .. image:: :alt: PyPI :target: .. image:: :alt: Known Vulnerabilities :target:


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


Copyright (c) 2012-2020 by Shoop Commerce Ltd. [email protected]

Shuup is International Registered Trademark & Property of Shoop Commerce Ltd., Business ID: FI27184225, Business Address: Iso-Roobertinkatu 20-22, 00120 HELSINKI, Finland.


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|

.. |Join chat| image:: :target:

Docker quick start

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

  1. Run:

    .. code-block:: shell

    docker-compose up

  2. Open localhost:8000/sa <http://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:

.. code:: sh

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:

.. code:: sh



  • Per object placeholders. Option to add content per contact group, category, product and CMS page. #1220 <>__ ✅.
  • Pricing cache. To improve the performance issues with complex catalog campaigns. #1163 <>__ ✅.
  • Improve shop product purchasable attribute. #1281 <>__ ✅.
  • 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 <>__ ✅.
  • OS Admin design/UX overhaul.
  • Various smaller issues from the issues-list.

OS Addons

  • Django-project template <>__. Django-project template.

  • Shuup API <>__. Shuup API.

  • Shuup REST API <>__. Shuup REST API.

  • Shuup Product Reviews <>__. Shuup Product Reviews.

  • Shuup Stripe <>__. Stripe Payment Processor Addon for Shuup.

  • Shuup Wishlist <>__. Shuup Wishlist Addon.

  • Shuup Checkoutfi <>__. integration for Shuup.

  • Shuup Yaml <>__. Import categories, manufacturers and products to Shuup.

  • Shuup Mailchimp <>__. Mailchimp integration for Shuup (New v0.7.8 released).

  • Shuup Xtheme Layouts <>__. Xtheme layouts for Shuup.

  • Shuup Category Organizer <>__. Shuup Category Organizer.

  • Shuup Logging <>__. Shuup Logging.

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.

  • Provides system <>__.
  • Core settings <>__.
  • Front settings <>__.
  • Admin settings <>__.
  • Extending Shuup <>__.

Admin Preview

.. image:: doc/_static/admin_shop_product.png :target: doc/_static/admin_shop_product.png :height: 300px

.. image:: doc/_static/admin_order_detail.png :target: doc/_static/admin_order_detail.png :height: 300px

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (46,960
django (898
ecommerce (185
ecommerce-platform (53
ecommerce-framework (14

Find Open Source By Browsing 7,000 Topics Across 59 Categories