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]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.

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

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 frontend product page,page for 24‑WB07, you can only add a maximum of 3 free samples because the default quantitylimit in the configuration is set to 3, allowing the product to be added to the cart, and the labelproduct’s Free‘Sample product max qty’ field in the admin under the ‘Sample Products’ section is displayedblank. forWhen productthat 24-WB07field is blank, it automatically uses the default value from the configuration, which is 3.

• 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 and leave all fields blank. If a field is empty, values will be taken from the default configuration settings. On the frontend product page, the default quantity is set to 3, allowing the product to be added to the cart, and the label Cost associated sample text is displayed for product 24-WB07

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.

• 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.

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).

• 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).

[](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.