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


Commerce 2.x requires Drupal 8.3.0 or newer.

If you already have a web server, make sure it satisfies Drupal 8’s requirements. The recommended memory limit is 256MB or more. For local development we recommend Drupal VM (advanced users) or Acquia Dev Desktop (beginners). You will also need Composer.

Why must we use Composer?

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 Drupal Console.
  • The web folder represents the document root.
  • Composer commands are always run from the site root (mystore in this case).
  • Downloading additional modules: composer require "drupal/devel:1.x-dev"
  • Updating an existing module: composer update drupal/address -–with-dependencies

See the project-base README for more details.

Existing site

Run these commands in the root of your website:

Add the Composer repository

This allows Composer to find Commerce and the other Drupal modules.

composer config repositories.drupal composer

Download Commerce

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

composer require "drupal/commerce 2.x-dev"

Enable Commerce (instructions below use Drupal Console)

drupal module:install commerce_product commerce_checkout commerce_cart