Installing Commerce to contribute back? Check out our Getting ready for development guide.

Be sure to review requirements before starting the installation process.

New site

The following command will download Drupal 8 + Commerce 2.x with all dependencies to the mystore folder:

 composer create-project drupalcommerce/project-base mystore --stability dev

Install it just like a regular Drupal site. Commerce will be automatically enabled for you.


  • The bin folder contains any library binaries, such as Drupal Console, PHPUnit, Behat, etc.
  • The web folder represents the document root.
    • If you host your site on Acquia Cloud or another service that requires Drupal in a subdirectory other than web, these instructions describe how you can relocate the docroot.
  • Composer commands are always run from the site root (mystore in this case).
  • See the Composer template for Drupal projects README for more details.

Existing site

Run these commands in the root of your website:

Download Commerce

This will also download the required libraries and modules (Address, Entity, State Machine, Inline Entity Form, Profile).

 cd /path/to/drupal8
 composer require "drupal/commerce"

Enable Commerce

The instructions below use Drupal Console

 drupal module:install commerce_product commerce_checkout commerce_cart

Alternative installation instructions for Ludwig users

Composer is the recommended way to install and maintain a site. Site administrators using Ludwig need to be careful when combining modules that depend on external libraries, since there are no safeguards against incompatible library versions or overlapping requirements.

These instructions assume you are working with an existing site. See the documentation on Installing Drupal 8 if you do not have an existing site.

Up-to-date Ludwig instructions can be found on the following page Drupal Commerce + Ludwig installation guide

Found errors? Think you can improve this documentation? edit this page