Marketplace Product Options feature overview

Edit on GitHub

With the Marketplace Product Options feature, merchants and Marketplace administrators can create product options for merchant 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, warranty, etc. 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:

  • product option group name
  • tax set assigned on the product option group
  • option value
  • translation

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. See Creating a product option for details on how you can create product options in the Back Office, Managing product options on how you can manage the product options in the Back Office, and File details: merchant product option group on how you can 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 product option was rejected by the Marketplace administrator, 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. See File details: merchant product option group for details.

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 created a product option group and assigned 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 image below, 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
Developer guides

Are you a developer? See Marketplace Product Options feature walkthrough for developers.