The ms_fractional_stock addon allows selling a specific quantity of a product or products with a floating quantity. Suitable for food products (in grams, kilograms), products sold in packages (boxes, crates) and other items with variable quantities.
Main features
- Fractional quantities: selling products with fractional amounts (1.5 kg, 2.3 l)
- Units of measure: configuring units (pcs., kg, l, m, etc.)
- Quantity step: configuring step (0.1, 0.5, 1)
- Min and max quantity: order limits
- Global settings: shared settings for all products or per-product
- Warehouses integration: fractional stock tracking
- Import/export: CommerceML and standard CS-Cart import/export support
How it works
On install, the addon runs migrations and adds fields to products and product_descriptions: allow_fractional_amount, ms_fractional_stock_use_global_settings, ms_unit_measure, ms_step_qty, ms_min_qty, ms_max_qty.
Cart hooks normalize quantity on add and update: round to step, check min and max. Product hooks handle fractional quantities and integrate with the warehouses addon.
Import/export schemas are extended for fractional quantities. Storefront JavaScript handles input and validation.
Where to find
Admin: addon settings, product card («MS: Fractional Stock» section), bulk product update.
Storefront: product page with fractional quantity input, cart and checkout.
Settings
Global: «Use fractional remainder», «Unit of quantity» (default «pcs.»).
Per product: use fractional remainder, global settings, unit of measure, quantity step, min and max quantity.
Technical requirements
Addon for MULTIVENDOR and ULTIMATE. Conflicts with csc_fractional_stock. Integrates with warehouses addon.
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Buyers
- Owners
- Vendors
- English
- Русский
- 4.18.X
- 4.17.X
Installation
- Ensure the addon is activated in Administration → Add-ons → Manage add-ons
- The addon auto-installs in MULTIVENDOR and ULTIMATE
- Important: Conflicts with
csc_fractional_stock— cannot use both - On install, migrations create required table fields
Configuration
- Go to Administration → Add-ons → Manage add-ons → MS: Fractional Stock
- Global settings: enable «Use fractional remainder», set default unit (pcs., kg, l)
- Save changes
Usage for administrator
Product setup: open product card, find «MS: Fractional Stock» section. Configure: use fractional remainder, global settings, unit of measure, quantity step, min and max quantity.
Bulk update: Administration → Products → Bulk edit — select products and configure fractional stock parameters.
Usage for customer
On product page with fractional remainder enabled, customer can enter fractional quantity (1.5, 2.3). Quantity rounds to step. Cart shows fractional quantity with unit.
Examples
- Food: unit «kg», step 0.1 — order 1.5 kg, 2.3 kg
- Liquids: unit «l», step 0.1 — order 0.5 l, 1.2 l
- Packages: unit «pkg», step 0.5 — order 1.5 packages
Verification
Configure product with fractional remainder, open storefront page, verify fractional input and step rounding. Check min/max limits.
Troubleshooting
- Fractional quantities not working — check addon activation and product settings
- Quantity not rounding — check quantity step
- Limits not working — check min/max settings
v1.2.0
23.02.2026
- [!] Fixed bug when adding common product from product card to wishlist — two products were added
- [+] Added "ms_unit_measure", "ms_step_qty" fields to frontend cart API
- [\*] Updated module template
v1.1.0
08.09.2025
- [\*] Changed algorithm for determining minimum product order quantity
- [!] Fixed bug when removing products from cart
- [\*] Module standardization
- [+] Added migration to change amount field type in cart products table from mediumint to float for mobile app
v1.0.0
25.04.2025
- [+] First release
Legend:
[+] Added | [-] Removed | [\*] Changed | [!] Bug fix
Here you can share your opinion and evaluate our work.
Your feedback helps us become better and offer you even better service.