Skip to main content

Magento 2 Bundle Items Inventory

Installation and User Guide for Magento 2 Bundle Items Inventory

Table of Contents

  1. Installation
    • Download Extension
    • Installation via app/code
    • Installation via Composer
  2. Configuration Settings for Bundle Items
    • General Settings
  3. Workflow
  4. Setting Up Bundle Items Association
    • Associating Bundle Items & Defining Quantities
    • Updating or Removing Bundle Associations
  5. Inventory Automation
    • On Purchase
    • On Refund
    • Out-of-Stock Handling
  6. What Customers See
  7. Bulk Import & Export
    • Bulk Import
    • Bulk Export

Installation

  • Download Extension: Once you have placed the order from our site then go to Account section and click on My Downloadable Products and download the extension package.

image (84) (1).png

  • 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 bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

     

text

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

{% content-ref url="../installation-via-composer.md" %} installation-via-composer.md {% endcontent-ref %}

Configuration Settings for Bundle Items

Go to Admin > Stores > Configuration > Scommerce Configuration > Security Base

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 - 2025-07-31T164813.407.png

Workflow

The Magento 2 Bundle Items Inventory extension allows store administrators to associate any number of component products with simple items in their catalogue—each with a precise quantity. This setup enables inventory deduction and restoration for both main and associated (bundle) items during purchases and refunds, streamlining complex product management and keeping total inventory accurate.

Setting Up Bundle Item Associations

Associating Bundle Items & Defining Quantities

  1. Navigate to Products:
    Catalog > Products in your Magento Admin.
  2. Edit a Simple Product:
    Open the product you want to add bundle items to (e.g., "Deluxe Gift Set").
  3. Find the 'Bundle Items' Tab:
    (This extension will add a new tab or section named Bundle Items)
  4. Add Bundle Items:
    • Click 'Add Bundle Item'.
    • Use the search/picker to select products you'd like to include (e.g., "Gift Box", "Greeting Card", "Ribbon").
    • Enter the number of each item required per unit (e.g., 1 ribbon per gift set, 2 cards per set).
  5. Save the main product to commit changes.

Example:
If "Family Baking Kit" requires 1 rolling pin, 2 spatulas, and 3 mixing bowls per kit, add each as a bundle item and specify quantities accordingly.

Updating or Removing Bundle Associations

  • To change quantities: Edit the relevant field next to each bundle item.
  • To remove an item: Use the remove/delete option within the grid.

image - 2025-07-31T164933.254.png

Inventory Automation

On Purchase

When an order containing the main product is placed:

  • The main product stock decreases by the quantity purchased.
  • Each bundle item's stock decreases based on the quantity defined per main product × number of mains sold.

Example:
Purchasing 4 "Spa Kits" (each requires 2 candles and 1 bottle of oil):

  • Main product: 4 deducted
  • Candles: 8 deducted (4 × 2)
  • Oil bottles: 4 deducted (4 × 1)

On Refund

When an order for the main product is refunded:

  • The main product stock increases by the quantity refunded.
  • Each bundle item's stock increases based on the refund quantity and their association.

Example:
Refund 2 "Family Baking Kits":

  • Main product: +2
  • Rolling pins: +2
  • Spatulas: +4 (2 × 2)
  • Mixing bowls: +6 (2 × 3)

Out-of-Stock Handling

By default, the main product can be purchased even if bundle items are out of stock.
(Future versions will allow configuration to prevent purchase if bundle items are unavailable.)

What Customers See

On the main product's page, your customers will see all associated bundle items and the quantities per unit (e.g. "Includes: 2 Candles, 1 Essential Oil Bottle per kit").

Bulk Import & Export

Bulk Import

  1. Prepare a CSV File: Each row should include:
    • Main Product SKU
    • Bundle Item SKU
    • Quantity per main product
  2. Go to:
    System > Data Transfer > Import
  3. Choose Entity Type:
    "Bundle Item Associations"
  4. Upload and Import:
    • The system validates:
      • All SKUs exist
      • Quantities are whole numbers
      • No duplicate relationships are present
    • Errors will appear with guidance to fix.

Sample CSV Format

main_product_sku bundle_item_sku quantity_per_unit
spa-kit candle 2
spa-kit oil-bottle 1
baking-kit spatula 2

image - 2025-07-31T165218.847.png

Bulk Export

  1. Go to:
    System > Data Transfer > Export
  2. Choose "Bundle Item Associations" as entity.
  3. Download the CSV:
    The export will show:
    • Each main SKU
    • Associated bundle SKUs
    • Quantities for each link

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