Integration Module 2.0 for Medusa is outRead the announcement
Multivendor Marketplace logo

Multivendor Marketplace

A multi-vendor Medusa plugin

npm install @techlabi/medusa-marketplace-plugin
Category
Built by
Version
0.66.0
Last updated
3 weeks ago
Monthly downloads
Loading downloads

Medusa Multivendor Marketplace Plugin

This plugin transforms your Medusa store into a robust multivendor marketplace.

Background

The plugin was created as a result of a four-part series articles on Medium re how to create multivendor marketplace with Medusa 2.0:

  • ๐Ÿ›  Part 1: setting up the multi-vendor structure and understanding how to manage multiple sellers on a single Medusa instance
  • ๐Ÿง‘โ€๐Ÿ’ผ Part 2: building a powerful Super Admin layer to oversee vendors, products, orders, and more
  • ๐ŸŽจ Part 3: customizing the Medusa Admin Dashboard to give super admins and vendors a clean, user-friendly experience
  • ๐ŸŽจ Part 4: bring it all together - packaging everything into a Medusa 2 plugin

Features

  • Store Creation:
    • The plugin provides an intuitive interface for creating new vendor stores, simplifying the onboarding process for new sellers.
  • Entity Separation:
    • The plugin ensures that each store has its own independent set of entities (customers, orders, products, etc.), preventing data conflicts and ensuring privacy.
  • Impersonation:
    • Super admins can seamlessly switch between vendor accounts, enabling them to:
      • View the marketplace from a vendor's perspective.
      • Troubleshoot issues efficiently.
      • Provide personalized support.

Installation

  1. Add plugin:

    yarn add @techlabi/medusa-marketplace-plugin
  2. Add the following variables to your file:

    • - The secret key used to create the super admin.
    • - The URL of your Medusa backend, required for custom admin components.
  3. Apply patch:

    To ensure proper setup, follow these steps:

    1. Open : Open the file in your project's root directory.

    2. Add script: Add the following script under the section:

    3. Run installation: Execute the installation process using yarn:

      yarn

      This script will automatically execute after all dependencies are installed, applying the necessary patch.

  4. Add the following code to your file:

    This code connect plugin and helps to resolve an issue similar to https://github.com/medusajs/medusa/issues/11248.

  5. Run database migrations:

    npx medusa db:migrate
  6. Start the project:

    yarn dev

Envs

  • - allow API keys management for regular vendors
  • - to disable signup widget on login page. Must be configured in :

Demo app

https://github.com/Tech-Labi/medusa2-marketplace-demo

Functionality Overview

Key features included:

  • Super Admin Role:
    • Introduces a super admin role with the ability to manage all aspects of the marketplace.
    • Super admins can:
      • Create and manage multiple vendor stores.
      • Impersonate vendor accounts to troubleshoot and provide support.
      • Access and analyze data across all stores.
  • Vendor Store Management:
    • Enables the creation of individual vendor stores, each with its own:
      • Customer Base: Independent customer lists for each vendor.
      • Order Management: Separate order tracking and fulfillment.
      • Price Lists: Unique pricing strategies for each vendor.
      • Product Catalogs: Distinct product offerings per store.
      • Shipping Profiles: Tailored shipping options.
      • Stock Locations: Independent inventory management.
      • User Accounts: Vendor-specific user management.
  • Data Separation:
    • The plugin ensures clear separation of data between stores using Medusa's module links:
    • This architecture allows vendors to operate independently while maintaining a cohesive marketplace experience for customers.

Creating a Super Admin

To create a super admin, use the following request:

Contributing

Feel free to contribute to this plugin by submitting pull requests or creating issues for bug reports and feature requests.

License

Apache 2.0