This add-on is part of our Subscription plan.
Subscribe once — enjoy all add-ons without limits.
MS: Packages helps sell products not only by individual units, but also by packs. It is useful for stores where the same product can be counted as pieces, boxes, bundles, cartons, or other package-based quantities.
Customers see clear quantities and prices on the storefront, while the store gets correct cart, order, and stock calculations based on the number of units in a pack.
Purpose
The add-on is designed for products that are sold in pack multiples while still requiring clear unit quantities for customers. For example, a store can sell a product by packs, show the unit price, and display the pack quantity in the cart at the same time.
Main features
- Sell products by piece, by pack, or in both modes at the same time.
- Configure the number of units per pack globally and for individual products.
- Choose how prices are calculated: per unit or per pack.
- Display pieces, packs, or both quantity types on the storefront.
- Choose which price is shown first on the product page.
- Automatically recalculate quantities when customers change pieces or packs.
- Check available stock based on the number of units inside packs.
- Display pack information correctly in the cart, mini-cart, and checkout.
- Support UniTheme2 and responsive checkout product list layouts.
- Bulk edit, export, and import pack-related product data.
How it works
- The administrator sets general sale rules: default sale mode, units per pack, price calculation, and storefront display mode.
- These rules can be overridden for individual products: the store can set a custom pack size and choose how customers change quantity.
- On the storefront, customers change the number of pieces or packs, and the add-on automatically recalculates the related value.
- In the cart and at checkout, customers see clear quantity controls, price, and line total, while the order is saved with the selected pack quantity.
Location in admin
Main settings are available in Add-ons -> Manage add-ons -> MS: Packages. Product-level settings are available in the product editing page on the MS: fractional stock and packaging tab.
Who it is for
The add-on is useful for wholesale and retail stores, B2B storefronts, food suppliers, consumables, construction goods, components, and any catalog where products are often sold as sets or packs.
Have questions about the add-on?
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Buyers
- Owners
- Vendors
- English
- Русский
- 4.18.X
- 4.17.X
Installation
- Open the CS-Cart admin panel.
- Go to Add-ons → Manage add-ons.
- Find MS: Packages.
- Click Install if the add-on is not installed yet.
- After installation, make sure the add-on is enabled.
General add-on settings
Open the add-on settings in Add-ons → Manage add-ons → MS: Packages.
- Sale type: choose the default product sale mode — by piece or by pack.
- Price: choose how the price is calculated — per product unit or per pack.
- Unit quantity: specify the default number of units in one pack.
- Display: choose what customers see on the storefront: pieces, packs, or both values.
- Stock check by units: enable it if stock should be checked by the actual number of product units, not only by packs.
Configuring an individual product
- Go to Products → Products.
- Open the product that should be sold in packs.
- Go to the MS: fractional stock and packaging tab.
- If the product needs individual rules, disable global settings for this product.
- Set the number of units per pack, sale type, price calculation mode, and storefront display mode.
- Save the product.
Storefront check
- Open the configured product page on the storefront.
- Check that the required quantity controls are displayed: pieces, packs, or both modes.
- Change the number of pieces and packs. The related value should be recalculated automatically.
- Make sure the price and line total match the selected quantity.
- Add the product to the cart.
Cart and checkout check
- Open the cart or checkout page.
- Check that the product displays the correct quantity controls.
- Change the product quantity in the cart or at checkout.
- Make sure the line total and order totals are recalculated without reloading the page if Ajax updates are enabled in the store.
- On narrow screens, check that price, quantity, total, and the remove button do not overlap.
Bulk editing and import
For large catalogs, use bulk product editing, export, and import. This helps fill pack parameters for a group of products faster and then check the result on the storefront.
If data is displayed incorrectly
- Check that the add-on settings and product-level settings have been saved.
- Make sure the product has a correct number of units per pack.
- Clear the CS-Cart cache and theme cache if the storefront appearance does not update after uploading changes to the site.
- Check the product on the storefront, in the cart, and on the checkout page after clearing the cache.
Changelog
v1.3.0
24.06.2026
Fixes and changes:
- Fixed order total and commission calculation when selling products in packs.
- Fixed cart totals recalculation after changing product quantity in UniTheme2.
- Fixed product list display on checkout when used together with Convenient Cart: price, quantity, total, and remove controls are aligned, with responsive layout for different screen sizes.
- Improved product display on checkout in UniTheme2.
v1.2.0
01.04.2026
Changes and improvements:
- Updated the module template.
v1.1.2
25.03.2026
Fixes and changes:
- Fixed module styles display in the UniTheme2 theme.
v1.1.1
01.10.2025
New features and improvements:
- Standardized the module.
Fixes and changes:
- Fixed adding a product from the product card to the wishlist: the product is no longer added twice.
v1.1.0
27.08.2025
New features and improvements:
- Changed price display.
- Added a setting that lets the store owner choose which price is shown first on the product page.
v1.0.0
25.04.2025
New features and improvements:
- First edition.