Marketplace Product Options feature overview

Edit on GitHub

With the Marketplace Product Options feature, merchants and Marketplace administrators can create product options for marketplace products.

Product options are product additions that a customer can select on the product detail page before adding the product to the cart. For example, the product options can be gift wrappings for products, insurance, or warranty. Product options do not have stock but an SKU linked to product abstracts. Thus, you cannot purchase them without buying a corresponding product.

Each product option is defined by the following:

  • Product option group name
  • Tax set assigned on the product option group
  • Option value
  • Translation

A product option group holds all available options or option values that buyers select. For example, you can have the Warranty product option group and create 1-year warranty and 2-year warranty values for it.


Currently, you can create and manage general product options via the Back Office. However, you can only import merchant product options.

Marketplace product options approval statuses

Product option groups created by merchants can have the following statuses:

  • Waiting for approval: The product option group was created by a merchant and waits for the Marketplace administrator’s approval. This is the default status assigned to all Marketplace product options that do not have a different approval status set.
  • Approved: The product option group was approved by the Marketplace administrator. Merchants can use it for their products and offers, so if it is active, the product option is displayed on the Storefront.
  • Denied: The Marketplace administrator rejected the product option, and merchants cannot use it for their products and offers. If they still use it, it will not be applied and will not be displayed on the Storefront.

Currently, you can only import the Marketplace options approval statuses. For details, see File details: merchant product option group.

Marketplace product options in the Back Office

In the Back Office, a Marketplace administrator can:

Marketplace product options on the Storefront

On the product detail page, the product option group (1) is displayed as a drop-down list with its option values (2).

Product options on the Storefront

The merchant product option groups are displayed on the Storefront only when:

  • The product option group status is active.
  • The product option group approval status is approved.

After a merchant creates a product option group and assigns it to their products, the product option group is displayed for all the offers of the products, including offers of other merchants. For example, in the following image, the Video King merchant’s offer is selected, but the Spryker merchant’s product option group is still displayed:

Marketplace product options on the Storefront

Marketplace product options in the Merchant Portal

In the Merchant Portal, the product options are displayed on the order details page as part of the order:

Product options on the order details page

Current constraints

Currently, the feature has the following functional constraints which are going to be resolved in the future:

  • Product option values of a product option group can be only from one merchant.
  • Product options of a merchant can be used with all offers from all merchants.
  • There is no Back Office UI for approving or denying merchant product options.
  • Glue API does not support merchant product option groups and values.
  • Merchants can not create and manage product option groups and values in the Merchant Portal.
Creating a product option
Managing product options
Install the Marketplace Product Options feature File details: merchant product option group
Merchant Portal - Marketplace Product Options Management integration