Marketplace Merchant feature overview

Edit on GitHub

A merchant is a seller of goods or services, either a business or a private person working in the Marketplace environment. Merchants manage their business in the Merchant Portal. The Merchant Portal lets merchants upload and manage merchant products and offers, define prices and stock, fulfill orders, and edit merchant profile information. Merchant can have employees who can access the Merchant Portal and perform actions on the merchant’s behalf there. These employees are referred to as merchant users.

Merchant is the core entity of the Spryker Marketplace and the second main entity after customers since the Marketplace connects the buying customers and the selling customers. Every merchant in the Spryker Marketplace has a unique identifier in the system called Merchant SKU.  You can create merchants in the Back Office or import merchants.

Merchant statuses

The Marketplace administrator manages merchants and sets their statuses in the Back Office. Merchant statuses define the level of access of the specific merchant to:

  • The Merchant Portal:
    • Waiting for approval. Once the merchant record is created, this status is applied.
    • Approved. Once the record is approved, the merchant receives an email with the password information required to access the Merchant Portal. When the merchant is approved, merchant users can log in and create offers and products in the Merchant Portal.
    • Denied. A Marketplace administrator can deny access to the approved merchant. If denied, the merchant cannot log in to the Merchant Portal.

  • The merchant profile page, product offers and marketplace products on the Storefront:
    • Active. This status can be set only for the approved merchants. It indicates that the merchant’s profile page is online, and the merchant can create offers and products. A merchant can also create offers and products and manage their sales activity.
    • Inactive. This status indicates that the merchant’s profile page, products, and offers are offline. It is the default status for the created merchant. With this status, the merchant can not perform their selling online.
Waiting For Approval N/A
Approved N/A
Denied N/A
Active N/A
Inactive N/A

For details about how to change the merchant statuses and activate or deactivate merchants in the Back Office, see Create merchants.


Whenever a merchant is denied, all the users (/docs/pbc/all/merchant-management/202311.0/marketplace/marketplace-merchant-feature-overview/merchant-users-overview.html) of this merchant get deactivated. Upon re-approval, the merchant users must be manually activated one by one.

Schematically, the merchant status change flow looks like this:

Merchant status flow

Merchant category

You can group merchants by categories to make your working process more efficient and simplify merchants’ search for customers. For details, see Merchant Category.

Merchants on the Storefront

Merchant profile

On the Storefront, customers can check the relevant merchant information on the Merchant Profile page.


The merchant profile page is available only if the merchant is Active.

The information for a merchant profile can be defined:

Viewing merchant profile

Merchant opening hours

To make the selling activity efficient, merchants can provide their working schedule that will display to buyers on the Storefront. For details, see Merchant Opening Hours feature overview.

Marketplace Storefront lets buyers check what merchants are the owners of the offers and products the customers are buying. The respective merchant names with the link to the merchant profile page are available:

  • On the product detail page

Merchant link on the PDP

  • On the cart page

Merchant link on the cart page

  • On the summary checkout page

Merchant link on the summary checkout page

  • On the order details page

Merchant link on the order details page

Searching and filtering by merchant name

In the Spryker Marketplace, you can search for the products sold by a specific merchant by entering the merchant name in the search field. The search results contain the marketplace products and/or the abstract products the merchant product offers are related to. The search suggestions and the auto-completion functionality provide the marketplace products and offers by the merchant name. Search by merchant name

In the catalog and search results pages, there is the merchant multi-select filter. This filter lets shoppers see only the products with the product offers belonging to the selected merchant. For more details about filters available in the Spryker Commerce O, see Standard Filters documentation.

Merchant search filter

If the merchant is not active, their products and offers are not displayed in the search suggestions, search results, and the merchant filter.

Next steps

Learn about merchant users

Merchant users overview Editing merchant’s profile details Create merchants
Main merchant concept Managing merchant users
Install the Marketplace Merchant feature Retrieving merchants File details: merchant.csv
Install the Marketplace Merchant Glue API Searching the product catalog File details: merchant_profile.csv
Install the Merchant Portal - Marketplace Merchant feature Retrieving autocomplete and search suggestions File details: merchant_profile_address.csv
Resolving the URL of the merchant page File details: merchant_stock.csv
File details: merchant_store.csv