Who Is This For?
StoreHub merchants who sell products with customisable options (like meal add-ons) or different versions (like sizes and colours), and need to choose between modifiers and variants.
Overview
This article covers two different ways to handle product options in StoreHub, and how to choose between them.
Modifiers let customers customise a single product at ordering time (e.g., 'Hot' or 'Iced' for a coffee, 'Add Extra Cheese' on a burger). Typically used by F&B businesses.
Variants are different sellable versions of the same product, each with its own stock count (e.g., a T-shirt in Small / Medium / Large, or Red / Blue). Typically used by Retail businesses.
This guide explains the difference, the rules for combining them with other features, and the step-by-step setup for each.
Before You Begin
Access to BackOffice (log in at your StoreHub BackOffice URL).
Products already added in BackOffice. If not, see this article first.
If you plan to set online prices for modifiers, make sure your online channels (Foodpanda, ShopeeFood, Beep/Webstore) are already connected.
Notes:
Modifiers cannot be created or updated using a CSV file import.
For shared modifiers, any prices you set for online channels must be entered as tax-exclusive.
Online modifier prices do not apply to your QR Order and Pay menu. QR Order and Pay uses the standard 'Add to Price' value.
Variants cannot be used to track ingredient-level (composite) inventory. If you need to track ingredients, use modifiers with composite inventory instead. See How to Set Up and Use Composite Inventory.
Step-by-Step Guide
What Is a Modifier?
A modifier is an option you add to a product that lets customers customize their order. Think of them as the questions you ask a customer before making their item. Modifiers can be free or have an additional cost.
Example:
A modifier group called 'How would you like your coffee?' could have options like 'Hot', 'Iced' (+RM 1.00), or 'Add Caramel Drizzle' (+RM 0.50).
This is different from a variant, which is used for different sellable versions of a single product (e.g., sizes and colours on a T-shirt). See Modifier vs Variant below for the full comparison.
What Is a Variant?
A variant is a different sellable version of the same product. Each variant is its own SKU with its own stock count, per store. Use variants when your product comes in different options that customers pick at the point of purchase and you need to track stock for each option separately.
Example:
A T-shirt product with variants for Size (Small, Medium, Large) and Colour (Red, Blue). Each combination (e.g., Small-Red) has its own stock count.
Variants are typically used by Retail businesses. F&B businesses should usually use modifiers instead. See the comparison below.
Modifier vs Variant
Use this table to decide which one fits your product:
| Modifier | Variant |
Purpose | Customisation on top of a product at ordering time. | Different sellable versions of the same product. |
Stock tracking | No separate stock per option (unless using composite inventory for ingredients). | Required. Each variant tracks stock per store. |
Best for | F&B: drinks, toppings, cooking preferences, add-ons. | Retail: sizes, colours, flavour packs, any sellable SKU differences. |
Pricing | Optional add-on price (e.g., '+RM 1.00'). | Each variant can have its own base price. |
Example | A latte with a 'Temperature' modifier (Hot / Iced) and a 'Milk' modifier (Full / Oat +RM 1.50). | A T-shirt with Size (S / M / L) and Colour (Red / Blue) variants, each row tracked as its own SKU. |
Rules to remember:
Modifiers and Variants cannot be used together on the same product. Pick one.
Variants require stock tracking. Track Stock Level must be enabled on the product.
Variants cannot be used with Composite Inventory. If you need ingredient-level tracking, use modifiers with composite inventory instead. See here.
Which Type of Modifier Should I Use?
Use a custom modifier if: | Use a shared modifier if: |
Your options are unique and apply to only one product. | You want to reuse the same set of options across many products. |
Example:
'Add Pickles' only applies to your 'Classic Burger'. | Example:
'Hot' or 'Cold' applies to all the drinks on your menu. |
Single Choice | Multiple Choice |
Use this if customers can only pick one option (e.g., a steak's cooking temperature can only be 'Rare' or 'Medium Well').
| Use this if customers can pick more than one option (e.g., a burger can have 'Add Pickles' and 'Add Extra Cheese').
 |
Set Up Custom Modifiers
Use these steps for options that are unique to a single product.
1. In your BackOffice, go to 'Products'.
2. Select the product you want to edit, or click '+ Add Product' to create a new one.
3. Scroll down to the 'Modifiers' section and tick the 'Has Modifiers' box.
4. Under 'Custom Modifier Groups', choose a type ('Single Choice' or 'Multiple Choice') and click '+ Add Group'.
5. In the 'Modifier Detail' section, add your options. You will see columns to set up each choice:
'Group Name': The name of the modifier group (e.g., 'Meal Size').
'Name': The name of the option (e.g., 'Extra Cheese').
'Add to Price': The standard price for in-store and QR Order and Pay orders.
6. If you use online platforms, you will also see a 'Price' field and a 'List on...' checkbox for each platform you use, such as 'Foodpanda', 'ShopeeFood', or your 'Beep/Webstore'.
Example:
Enter the price you want to charge for this modifier on that platform (e.g., 'Foodpanda Price').
Tick 'List on Foodpanda' to make the modifier available on Foodpanda. Untick it to hide it.
7. Click 'Save' at the bottom of the page when you have added all your options.
Set Up Shared Modifiers
Use these steps for options you want to reuse across many products. The process has two parts: creating the group, then linking it to products.
Part 1: Create the Shared Modifier Group
1. In your BackOffice, go to 'Products', then click 'Modifier Groups'.
2. Click 'Create a Modifier Group'.
3. In the 'Modifier Detail' section, enter a 'Group Name' for your modifier (e.g., 'Drink Temperature').
4. Choose a modifier 'Type'.
Notes:
Single Choice: Use this if customers can only pick one option (e.g., a drink can be 'Hot' or 'Cold').
Multiple Choice: Use this if customers can pick more than one option (e.g., a coffee can have 'Extra Shots' and 'Add Whipped Cream').
5. Under 'Modifier Options', add a row for each choice and fill in the details:
'Name': The name of the option (e.g., 'Hot', 'Cold').
'Add-on Price': The standard price for in-store and QR Order and Pay orders.
6. If you use online platforms, you will also see a 'Price' field and a 'List on...' checkbox for each platform (e.g., 'Foodpanda Price', 'List on Foodpanda').
7. Click 'Publish & Next'.
Part 2: Link the Group to Products
1. After creating the group, click the 'Add Products' tab.
2. Under the 'Linked Products' tab, click 'Link Product'.
3. Tick the box next to each product you want to link, then click 'Link Products'.
4. A pop-up will appear asking for confirmation. Click 'Confirm'.
Your linked products will now appear under the 'Linked Products' tab.
Set Up Product Variants
Variants are best suited for retail businesses. They let you add single-selection options to a product (e.g., colour, size) and track stock for each combination across stores.
1. In your BackOffice, go to 'Products'.
2. Click '+ Add Product' to create a new product, or select an existing product to edit.
3. Enter the product name, pricing, and other details.
4. Scroll down to the 'Inventory & Variants' section. Tick 'Track Stock Level' and 'Has Variants'.
5. Under 'Variants', click 'Add Group'.
6. Name your group of variants (e.g., 'Colour', 'Size') and add the options (e.g., 'Red', 'Blue', 'Green').
7. Click 'Save'.
8. After saving, the variants will appear at the bottom of the product page. Enter the stock quantity for each variant in each store.
Note:
You can also upload products with variants in bulk using the CSV import template. See here.
Manage Existing Modifiers
To view, edit, or delete your shared modifier groups, go to 'Products' in your BackOffice and choose 'Modifier Groups'.
Edit a Modifier Group
1. On the 'Modifier Groups' page, click the pencil icon next to the group you want to edit.
2. Make your changes and click 'Save'.
Delete a Modifier Group
You can delete a modifier group using one of two methods.
Option A: Delete from the Main List (Batch Delete)
1. On the 'Modifier Groups' page, tick the boxes next to the group(s) you want to delete.
2. Click the three-dots icon on the right and select 'Delete Modifier groups'.
Option B: Delete from the Edit Page
1. Click the pencil icon on the group you want to delete.
2. On the edit page, click the three-dots icon in the top-right corner and select 'Delete Modifier Group'.
Troubleshooting
Issue | Solution |
Modifier prices are not showing on my online channel | Make sure you have entered a price in the platform-specific price column (e.g., 'Foodpanda Price') and ticked the 'List on...' checkbox for that platform. |
I cannot find the online price columns | Scroll the modifier table horizontally. If you have many online channels, the columns may be off-screen to the right. |
Modifier options are not appearing on QR Order and Pay | Online modifier prices do not apply to QR Order and Pay. QR Order and Pay uses the standard 'Add to Price' value. Make sure you have set the 'Add to Price' value. |
Min/Max choices are not working on online orders | The Min/Max Choices setting only applies to POS orders. It does not apply to online orders. |
I want to track ingredients used by each modifier option | Use composite inventory with modifiers. See this article for steps. |
I marked an optional modifier or modifier group as out of stock, but the whole product shows as out of stock | Check how stock is set for the parent product and for modifier options. Optional modifiers can still affect how the product appears when stock rules tie the parent item to modifier stock. Review each modifier option's stock settings and the product's inventory type.
If the issue is only on the POS register, see this article for out-of-stock sales settings. |
My modifier has its own stock. Do I still track stock on the main product? | If you track ingredients per modifier using composite inventory, follow this article.
If the modifier is a simple add-on without composite setup, stock rules depend on how the product is configured. |
Variant stock quantities not updating | Make sure you entered stock quantities in the variant table at the bottom of the product page after saving. Stock must be set per variant per store. |
Parent product shows price 0 but my variant prices are correct | Check the parent product price field and each child variant price. Many merchants set the parent to 0 when all sellable prices live on variants. If POS should show a default, set a base price on the parent or confirm each variant row has the price you expect. |
Error message: Children products must have at least one variant specified | Open the product, go to the variant section, and make sure each required variant group has at least one option selected or saved. Save the product, then sync POS. |
A variant does not appear on my POS layout | Check the product is in the category or layout group assigned to that POS screen. Update the POS layout in BackOffice and sync the register. |
I sell one bottle and a three-bottle pack. Should I use variants or modifiers? | Use variants when each option is a different sellable SKU with its own stock (for example, 1 bottle SKU and 3 bottle SKU). Use modifiers for add-ons that do not change the base SKU the same way. See the Modifier vs Variant section at the top of this guide. |
FAQs
1. Can I have multiple variant groups on one product?
Yes. You can add multiple groups (e.g., 'Colour' and 'Size') and the system will create combinations (e.g., Red-Small, Red-Medium, Blue-Small, Blue-Medium).
2. I sell many brands of bottled beer and need stock per brand. Variants or modifiers?
Use variants when each brand is a different SKU with its own stock count. Use modifiers when the same base SKU only changes add-ons (for example, ice, lime) and stock is not tracked per add-on.
3. What is the difference between a modifier and a variant?
A modifier adds customizable options to a product (for example, Hot or Iced for a coffee). A variant creates different versions of a single product (for example, a T-shirt in Small, Medium, or Large). F&B businesses should use modifiers. Retail businesses typically use variants.
4. Can I create modifiers using a CSV file?
No. Modifiers must be created manually in the BackOffice. CSV import does not support modifiers.
5. Can I set different modifier prices for different online channels?
Yes. Each online platform you use (Foodpanda, ShopeeFood, Beep or Webstore) has its own price column in the modifier table. Enter the price you want for each platform. These prices must be entered as tax-exclusive for shared modifiers.
6. What happens if I delete a shared modifier group that is linked to products?
The modifier options will be removed from all linked products. Customers will no longer see those options when ordering.
7. Can I use both custom and shared modifiers on the same product?
Yes. A product can have both custom modifiers (unique to that product) and shared modifiers (reused across products) at the same time.
8. I sell the same dish as a set meal and ala carte. How do I track one pool of stock (for example, chicken pieces)?
Use one ingredient product with simple inventory, then use composite inventory on each sellable product (set and ala carte) so each sale deducts from the same ingredient stock. See here.
9. If a modifier is optional, should I still turn on stock tracking for it?
Only if you need the register or channels to block that option when it runs out. If you use composite inventory, ingredient stock is usually tracked on the ingredient product, not on the modifier label alone.
10. Can customers choose a variant (for example, size) before they pick modifiers?
Variants and modifiers are set up on the product in BackOffice. If you need a specific order of questions on the POS, check your product uses variants for the size step and modifiers for add-ons.
Need Help?
Contact StoreHub Support via live chat in your StoreHub app or email [email protected].
Was This Article Helpful?
Let us know below or contact support for further assistance.