Selling by Unit (kg, metre, litre)

Sell a product by weight, length or volume: pick the selling unit, set the price per unit, minimum quantity and step, and see how customers buy decimal quantities in your store.

Selling by unit lets a product be priced per kilogram, metre, litre or any other unit you have switched on, and lets customers buy a decimal quantity such as 2.5 kg. You set it on the product itself, in a card called Selling unit. A product left on Piece (pcs) behaves exactly as before.

Availability: switched on per environment

Selling by unit ships off, in both the admin panel and the storefront. BillionBiz turns it on environment by environment: it is on for the UAT test environment and not yet enabled for live stores. Until it is on for your environment, the Selling unit card does not appear on Add product or Edit product, and customers always see the normal price and whole-number quantities. If you set a unit but customers do not see it, see Troubleshooting below.

What you get

A Selling unit card on product Add and Edit, in both the new and the classic admin.
The price you already enter becomes the price per unit.
A Minimum quantity and a Step (for example 0.5 kg) that the storefront quantity control follows.
Stock held in the same unit, with decimals, and shown with its unit in the product list.
A storefront that shows the price as "₹X / kg", accepts decimal quantities, and shows the unit in the cart and on orders.

Before you start

The unit you sell by must be switched on for your store. Go to Settings → Units and turn on the unit (for example kilogram) or create your own. See Units & Measurement Pricing. Switched-off units are not offered in the Sold by list.

Set up a product that sells by unit

The Selling unit card is in the same place on every screen where you add or edit a product:

New admin: Products → Add product or Products → Edit product.
Classic admin: Inventory → Add Product or Inventory → Edit Product.

The card sits above Pricing & stock (in the new admin) and above the pricing and stock fields in the classic dialogs.

Choose Sold by

Open the Sold by list and pick the unit. The default is Piece (pcs), which means the product is sold the usual way. While it is on Piece, the card only says "Sold by the piece. Pick another unit to sell by weight, length or volume."

Read the price note

Once you pick another unit, the card says "The price below is now the price per" that unit, and "Customers can buy decimal quantities." The price field you already use is now your price for one unit, for example the price of 1 kg.

Enter the price

Enter your price in the normal price field. It is the price per unit.

Set Minimum quantity and Step

Two fields appear, labelled with the unit, for example Minimum quantity (kg) and Step (kg). Minimum quantity is the least a customer can buy (for example 0.5). Step is how much the quantity moves with each press of plus or minus (for example 0.5). Each must be a number above 0 with up to 3 decimals, otherwise the field turns red and shows "Enter a number above 0 with up to 3 decimals." You may leave either blank, in which case the server default is used.

Enter stock in the unit

Stock is counted in the same unit and accepts up to 3 decimals. For a product left on Piece (pcs), stock must be a whole number: typing a fraction shows "Whole numbers only — this product is sold in pieces" under the field, and saving is blocked with "Enter stock as a whole number." until you fix it. The field is labelled Stock in kg (with your unit) in both the new admin and the classic dialogs. An invalid value shows "Enter stock in kg with up to 3 decimals."

Save

Save the product as usual. If the server rejects the unit settings, the reasons are listed in a red box inside the Selling unit card.

Go back to selling by the piece

Set Sold by back to Piece (pcs) and save. The unit, minimum quantity and step are cleared from the product, and the storefront returns to the normal price and whole-number quantities. Saving a product you did not touch the Selling unit card on leaves its unit settings as they were.

Not the same as Unit measure

The Unit measure section described in Adding & Editing Products is a separate, older set of fields. Selling unit is what changes how the product is priced and bought.

See units in the product list

Where the product list shows stock, a product sold by unit shows its unit after the number, for example "12.5 kg". Piece products show the bare number as before. The list is Inventory in the classic admin and Products in the new admin.

You can also open the list filtered to one unit with the View products shortcut on Settings → Units (see Units & Measurement Pricing). The filter matches products sold in that unit. There is no unit dropdown on the list itself.

See the price per unit in the admin

A product sold by unit also shows its price with the unit, for example "₹120.00 / kg". Piece products show the plain price with no suffix. It appears in these places:

Classic admin: the Price column of Inventory, and the Price line on the product's detail page.
New admin: the Price column of Products in list view, and under the product name on each card in grid view.
Product editor (both admins): inside the Price / MRP field of the Pricing & stock card, shown after the number as "/ kg". It follows the unit chosen under Sold by, so it changes as soon as you pick a different unit, before you save.

Why doesn't my product show / kg in the product list?

The suffix only appears for a product whose selling unit is something other than Piece (pcs), and only when measured selling is turned on for your store. A product left on pieces shows the plain price.

What customers see

Product cards and listings

Measured products show a per-unit price label such as "₹40 / kg" on the card. This includes the product grids on your store's home page (for example Best selling, New arrivals, Trending now, Featured collection and Flash sale sections), not just the shop and collection listings. A whole-rupee rate drops its decimals ("₹120 / kg"); a fractional rate keeps them ("₹12.50 / kg"). Products sold in pieces never show it and keep the normal price. If the product has a minimum quantity, the card's button adds that minimum quantity to the cart in one tap. If it has none, the button reads Choose quantity and opens the product page instead.

Product page

The price is followed by the unit, for example "₹120 / kg". When your price is set per a larger or smaller amount, the label includes that amount, for example "/ 500 g". Pieces products show no label. The quantity control accepts decimals: it starts at the minimum quantity, moves by the step, and shows the unit next to the number. The total for the chosen quantity comes from the server, not from the browser, so it always matches what you will charge. On a phone, the sticky buy bar at the bottom of the product page also carries a compact quantity stepper (minus, the quantity with its unit such as "2.5 kg", plus) beside the add-to-cart button, so the customer can change the amount without scrolling back up. It moves by the same step and stays within the same minimum and maximum. It only appears for products sold by unit.

Cart

Each measured line carries a rate caption under the item, for example "2.5 kg × ₹40 / kg" (the quantity with its unit, times your rate per unit). Pieces lines show no caption. Changing the quantity asks the server to price the line again. Adding the same measured product again, with the same unit and the same options, adds to the line that is already in the cart instead of creating a second one: 2.5 kg plus 2.5 kg becomes one line of 5 kg. The new total is checked again against the product's minimum, maximum, step and stock, and the add is refused if it does not fit. If the customer enters the amount in a different unit (for example 3000 g instead of kg), that makes a separate line. The cart badge and the "(N items)" count in the summary count a measured line as 1 item, not as 2.5.

Checkout

Nothing extra happens when prices have not moved. If the price changed since the item was added, the customer sees a Price updated box reading "Price updated — ₹40 → ₹45" with two buttons: Back to cart and Continue to pay. Payment only goes ahead at the new price after they choose Continue to pay. Carts that contain only normal pieces never trigger this box.

Order confirmation and order history

The order confirmation page shows each line with its quantity and unit, for example "Qty: 2.5 kg" or "Basmati rice × 2.5 kg" depending on the store's order confirmation design; pieces lines show the bare number. Its Subtotal is the sum of the items, with shipping and discount shown as separate lines. The customer's order detail page (open an order from the customer's order history) shows the quantity with its unit beside each measured item, for example "Qty: 2.5 kg". Pieces lines show the bare number as before.

Reorder

On the order detail page, Reorder (all items) and the per-item reorder button add measured lines back to the cart with the same measured amount and unit as the original order, for example 2.5 kg again, not 2.5 pieces. The cart then prices the line at your current rate, and the usual minimum, maximum, step and stock checks apply. Pieces lines are re-added by their quantity as before. A measured line is re-added with its variant, so if the same variant of that item is already in the cart with the same unit, the amounts merge into one line (2.5 kg already in the cart plus a 2.5 kg reorder becomes 5 kg), subject to the same limit checks.

The unit written next to quantities on the storefront is the unit's short code, for example kg.

Other places the unit shows

A measured product carries its unit into every other place a customer meets it. For a product on Piece (pcs), none of these change.

Quick view, search and recently viewed

The quick view window, the search overlay suggestions, the search results grid and the recently viewed carousel all write the price with its unit, for example "₹40 / kg", the same label as the product cards.

Invoices

When selling by unit is on, the invoices you generate from Orders show the quantity with its unit for each measured line, for example "4 kg" in the Qty column, in all the invoice layouts (Classic, Modern, Minimal and GST Detailed). A product with a custom unit prints the unit's label. Pieces lines print the bare number.

Where an invoice shows an HSN summary, it groups lines by HSN code and unit. So 4 kg and 2 pcs sold under the same HSN appear as two rows ("4 kg" and "2"), never added together as 6. Invoices already finalised keep the unit they were issued with.

Troubleshooting

Customers still see the plain price and whole quantities

Check these in order:

The product is still on Piece. Open the product and confirm Sold by is not Piece (pcs), then save.
The unit is switched off. Go to Settings → Units and confirm the unit is Enabled. A switched-off unit is not offered in Sold by.
The feature is off for your environment. If you cannot see the Selling unit card at all, selling by unit has not been turned on for your admin panel. If the card shows but the storefront looks unchanged, it has not been turned on for your storefront. Ask BillionBiz support to enable it.

A customer cannot buy less than a certain amount

That is the Minimum quantity. The storefront quantity control will not go below it, and it moves only by the Step. Lower the minimum or step on the product and save.

The unit only shows for a product that is set to sell by unit (Sold by is not Piece (pcs)) while selling by unit is turned on for your storefront. A product on Piece, or a storefront where BillionBiz has not turned the feature on, shows the plain price everywhere. Check the product's Sold by first, then see the steps above.

The home page grid shows the plain price, not "/ kg"

The home-page sections show the per-unit label only for a product whose Sold by is not Piece (pcs), while selling by unit is on for your storefront. Confirm the product, then reload the storefront. If the shop page shows "/ kg" but a home-page section does not, check that the section is showing that product (a hand-picked or collection section reads the product's current data).

The cart line has no rate caption, or reorder added pieces

The caption and the measured reorder only apply to lines added with a unit. A line added while the product was on Piece, or a store where selling by unit is off, behaves as a normal pieces line. Re-add the item from the product page.

The admin order shows a number but no unit

The order detail Items table, Packing slip, refund dialog and drawer, and the customer order dialog show the unit only for lines bought by unit. Pieces lines, and lines placed before the product was sold by unit, show the bare number.

The invoice quantity shows no unit

Check that the order line was bought by unit (the order detail page shows "Qty: 2.5 kg") and that selling by unit is on for your environment. Pieces lines, and every invoice when the feature is off, print the bare number. An invoice that was already finalised before the line carried a unit keeps its original quantity text; generate a new one for later orders.

Card shows Choose quantity instead of adding to the cart

The product has no minimum quantity available to the storefront. Enter a Minimum quantity on the product and save.

Why is my product's stock showing 0 in the editor?

A product with no variant rows keeps its stock on the product itself. Older editor builds showed 0 for these products; the editor now shows the product's real stock. If you still see 0, reload the page and check the stock on the product list.

Why can't I save 2.5 stock?

If Sold by is Piece (pcs), stock must be a whole number. A fractional value such as 2.5 shows "Whole numbers only — this product is sold in pieces" under the stock field, in the classic Add and Edit product dialogs and in the new editor's Pricing & stock card. Either enter a whole number, or change Sold by to a unit such as kg, where stock accepts up to 3 decimals.

The server rejected my unit settings

The red box in the Selling unit card lists each reason. Fix the field it names (for example a step that does not fit the unit) and save again.