# Magento 2 Barcode Scanner
### Installation and User Guide for Magento 2 Barcode Scanner extension
**Table of Contents**
1. [*Installation* ](#bkmrk-installation)
- *Installation via app/code*
- *Installation via Composer*
2. [*Configuration Settings for Barcode Scanner*](#bkmrk-configuration-settin)
- *General Settings*
- *Sample Product Settings*
3. *[Configure a Sample Product](#bkmrk-configure-a-sample-p)*
4. *[Configure a Simple Product](#bkmrk-configure-a-simple-product)*
5. *[Coupon code doesn't work for a Sample product](#bkmrk-coupon-code-doesn%27t-)*
### 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 .
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-05/image-52.png)
#### Barcode Scanner 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 .
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-01/Ivcimage.png)
- **Barcode Attribute –** Please select the Barcode attribute from the options.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-01/khtimage.png)
- **Order Statuses to pick –** Please select the Order Statuses from the options.
- **Change Status on Pick -** Select Yes or No to Change the status on pick.
- **Pick Order Status -** If you select Yes, then choose the Pick Order Status from the options.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-01/uaFimage.png)
- **Order Statuses to pack –** Please select the Order Statuses from the options.
- **Change Status on Pack -** Select Yes or No to Change the status on pack.
- **Allow Partially Picked Items -** Select Yes or No to Allow Partially Picked Items.
- **Pack Order Status -** Please select the Pack Order Status from the options.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-01/Rc8image.png)
- **Progressbar Color –** Please select the Color code for Progressbar
- **Progressbar Text Color –** Please select the Color code for Progressbar Text Color
- **Progress Status Color –** Please select the Color code for Progress Status Color
- **Complete Status Color –** Please select the Color code for Picking and Packing Complete Status
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-01/PUwimage.png)
### **Add a Barcode Scanner to a Product**
Log in to the Admin Panel, navigate to **Admin >Catalog > Products**, and select the product you want to edit. Click *Edit*, then scroll down to the Barcode field. Enter the value **12345678**, save the changes, and create an order for the product to which you added the Barcode (24-MB01).
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-02/image.png)
### **Scan Orders**
Go to **Admin > Sales > Scan Orders**. Enter the order number in the Scan Order field. The system will then display the status as Pending under Order Status, Pick Status, and Pack Status.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-02/o8Eimage.png)
Then go to **Admin > Sales > Orders**. Create the invoice and ship the order. Once completed, the order status will display as Complete in Scan Orders.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-02/iJQimage.png)
Next, enter the Barcode value **12345678** in the Scan Items field for Pick and again in the Scan Items field for Pack. Once completed, the status will update to Complete
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-02/h7oimage.png)
You can check the Barcode Scan Logs by navigating to **Admin > Sales > Orders > Edit > Barcode Scan Logs**. All order statuses will be shown as Success.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-02/Jq6image.png)
### **Configuring “Change Status on Pick” and Barcode Scanner Workflow**
When you set **“Change Status on Pick”** to Yes and configure the Picked from Pick Order Status under **Admin > Stores > Configuration > Barcode Scanner**, then place an order and click on **Scan Items for Pick**, you can enter the barcode scanner value in front of the item. The status should then update to Picked and Complete. Please refer to the screenshot below for reference.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-02/ERsimage.png)
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-02/9teimage.png)
If you have a question related to this extension please check out our [**FAQ Section**](https://www.scommerce-mage.com/magento-2-sample-products.html#customfaq) first. If you can't find the answer you are looking for then please contact [**support@scommerce-mage.com**](mailto:core@scommerce-mage.com)**.**