The project is in a healthy, maintained state
Spree Commerce multi vendor marketplace extension



~> 1.0
>= 4.3.0.rc1
>= 4.3.0.rc1
>= 4.3.0.rc1
 Project Readme

Spree Multi Vendor

This is a spree multi vendor marketplace extension. It's a great starting point if you're building a marketplace on top of Spree. Our goal was flexibility to allow you to tweak it to your needs.

Developed by


All-in-one platform for all your Marketplace and B2B eCommerce needs. Start your 30-day free trial

Open source vs Vendo

If you need a product that has all of the features out of the box, such us supplier onboarding, Stripe connect payment splitting and payouts, and don't require any custom development - we recommend using Vendo which is also based on Spree.

feature open source vendo
basic vendorization ✔️ ✔️
supplier onboarding ✔️
supplier dashboard ✔️
supplier management ✔️
supplier product curation ✔️
automatic payment splitting ✔️
automatic payouts ✔️
Afterpay / klarna / apple pay ✔️
shopify / bigcommerce / woocommerce integration ✔️
USPS, UPS, FedEx, DHL, and more ✔️
bulk upload / import of products from CSV and XSLX ✔️
bulk export of orders, shipments and more ✔️


  1. Add this extension to your Gemfile with this line:

    gem 'spree_multi_vendor'
  2. Install the gem using Bundler:

    bundle install
  3. Copy & run migrations

    bundle exec rails g spree_multi_vendor:install
  4. Restart your server

    If your server was running, restart it so that it can find the assets properly.

  5. Optionally you can also create sample Vendor by running:

    bundle exec rake spree_multi_vendor:sample:create


  1. Fetch new database migrations:

    bundle exec rake railties:install:migrations FROM=spree_multi_vendor
  2. Run migrations

    bundle exec rails db:migrate


To change which models should be vendorized, in your Spree initializer (config/initializers/spree.rb) add:

SpreeMultiVendor::Config[:vendorized_models] = %w[product variant stock_location shipping_method other_model]

This will lookup for Spree::OtherModel class. To add vendor_id column to that model run:

bundle exec rails g migration AddVendorToSpreeOtherModels vendor:references

API endpoints

Spree Multi Vendor adds new API v2 endpoints:

  1. GET Display Vendor information endpoint


    eg. /api/v2/storefront/vendors/test-vendor

    you can also include Vendor image and/or Products in that call:


  2. GET Returns a list of Vendors


    you can also include Vendor image and/or Products in that call:


And modfies existing:

  1. GET Filtering Products by Vendor ID(s):

  2. GET Include Vendor information in Cart endpoint:


Email previews

Spree offers emails preview generator for development purposes. To generate them, use command:

bundle exec rails g spree_multi_vendor:mailers_preview

After that, start rails server locally and go to: localhost:3000/rails/mailers

(it requires seeded development database in order to work properly)


First bundle your dependencies, then run rake. rake will default to building the dummy app if it does not exist, then it will run specs. The dummy app can be regenerated by using rake test_app.

bundle exec rake

When testing your applications integration with this extension you may use it's factories. Simply add this require statement to your spec_helper:

require 'spree_multi_vendor/factories'


If you'd like to contribute, please take a look at the instructions for installing dependencies and crafting a good pull request.


Spree Multi Vendor is copyright © 2017-2021 [Spark Solutions Sp. z o.o.][spark]. It is free software, and may be redistributed under the terms specified in the LICENCE file.

About Vendo

Vendo is a great fit for marketplaces of all sizes - either with own fulfillment and multiple warehouses or in a dropshipping model. Vendo automates everything from vendor onboarding, accepting buyer payments in over 135 currencies, to supplier payouts in 50 countries.

Vendo ensures excellent buyer experience with smooth product discovery and search, a multitude of payment methods and optimal shipping cost calculation. Vendo keeps suppliers happy with easy onboarding, automated products sync using their preferred method and easy payouts.

Start your 30-day free trial