Skip to main content

Magento 2 Sample Product

Installation and User Guide for Magento 2 Sample Product extension

Table of Contents

  1. Installation
    • Installation via app/code
    • Installation via Composer
  2. Configuration Settings for Sample Product
    • General Settings
    • Sample Product Settings
  3. Configure a Sample Product
  4. Configure a Simple Product
  5. Coupon code doesn't work for a Sample product

Installation

  • Installation via app/code: Upload the content of the module to your root folder. This will not overwrite the existing Magento folder or files, only the new contents will be added. After the successful upload of the package, run below commands on Magento 2 root directory.

    php php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

  • Installation via Composer: Please follow the guide provided in the below link to complete the installation via composer.

https://docs.scommerce-mage.com/magento-2-extensions/installation-via-composer/installation-via-composer

Configuration Settings for Sample Product

Go to Admin > Stores > Configuration > Scommerce Configuration > Sample Product

General Settings

  • Enabled – Select "Yes" or "No" to enable or disable the module.
  • License Key – Please add the license for the extension which is provided in the order confirmation email. Please note license keys are site URL specific. If you require license keys for dev/staging sites then please email us at support@scommerce-mage.com.

image (52).png

Sample Product Settings

  • Enabled – Select "Yes" or "No" to enable or disable the module.
  • License Key – Please add the license for the extension which is provided in the order confirmation email. Please note license keys are site URL specific. If you require license keys for dev/staging sites then please email us at support@scommerce-mage.com.
  • Default Free Sample Text – Please add the Default Free Sample Text
  • Default Sample with Cost Associated Text – Please add the Default Sample with Cost Associated Text
  • Default Sample Price with Cost Associated - Please add the Default simple price with cost associated
  • Default Max Qty to order samples - Please add the Default max qty to order samples

image.png

Configure a Sample product

  • Free Sample

Login to the Admin Panel, navigate to Catalog > Products, and select the product you want to edit. Click Edit, then scroll down to the Sample Product section. From the Sample Type dropdown, choose Free Sample and leave all fields blank. If a field is empty, values will be taken from the default configuration settings. On the product page for 24‑WB07, you can only add a maximum of 3 free samples because the default limit in the configuration is set to 3, and the product’s ‘Sample product max qty’ field in the admin under the ‘Sample Products’ section is blank. When that field is blank, it automatically uses the default value from the configuration, which is 3.

image.png

image.png

image.png

  • Sample with Cost Associated

From the Sample Type dropdown, select Sample with Cost Associated.

  • If you leave all fields empty, the system will automatically use the default price, title, and quantity from the configuration settings.
  • If you enter values in these fields, the system will use the product‑level values set
  •  in the Sample Products section instead

image.png

image.png

image.png

Configure a Simple product

  • Free Sample

Login to the Admin Panel, navigate to Catalog > Products, and select the product you want to edit. Click Edit, then scroll down to the Sample Product section. From the Sample Type dropdown, choose Free Sample. Set the Sample Price to 10, the Sample Product Max Qty to 5, and enter Sample New in the text field. On the frontend product page, add a quantity of 5 to the cart. The label Sample New is displayed for product 24-WB07, and Free Sample is shown on the Cart and Checkout pages. Please refer to the screengrabs below.

image.png

image.png

image.png

image.png

  • Sample with Cost Associated

Login to the Admin Panel, navigate to Catalog > Products, and select the product you want to edit. Click Edit, then scroll down to the Sample Product section. From the Sample Type dropdown, choose Sample with cost Associated. Set the Sample Price to 10, the Sample Product Max Qty to 5, and enter Sample Product Text in the text field. On the frontend product page, add a quantity of 5 to the cart. The label Sample Product Text is displayed for product 24-WB07, and Sample with cost Associated is shown on the Cart and Checkout pages. Please refer to the screengrabs below.

image.png

image.png

image.png

image.png

Coupon code doesn't work for a Sample product

  • Free Sample

Login to the Admin Panel, navigate to Marketing > Cart Price Rules, and create a coupon code named “testcode”. When applied on the cart page, this coupon should not be valid for Sample product (24-WB07).

image.png

image.png

  • Sample with Cost Associated

Login to the Admin Panel, navigate to Marketing > Cart Price Rules, and create a coupon code named “testcode”. When applied on the cart page, this coupon should not be valid for Sample product (24-WB07).

image.png

[![image.png](https://docs.scommerce-mage.com/uploads/images/gallery/2026-01/scaled-1680-/NZBimage.png)](https://docs.scommerce-mage.com/uploads/images/gallery/2026-01/NZBimage.png)

If you have a question related to this extension please check out our FAQ Section first. If you can't find the answer you are looking for then please contact support@scommerce-mage.com.

Back to top