> ## Documentation Index
> Fetch the complete documentation index at: https://docs.duitpos.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Modifiers
> Set up product options like size, extras, or cooking preferences.
**Modifiers** let customers customise a product — for example, choose a size, add toppings, or specify cooking level. Modifiers follow a three-layer structure: you create a **Modifier Group** (e.g. "Cheese Options"), add **Modifier Items** to it (e.g. "No Cheese", "Regular Cheddar", "Extra Cheddar" with prices), and then create **Mappings** to link that group to products or categories so those options appear during checkout.
## The Three-Layer Model
Understanding the structure helps you scale your menu efficiently:
1. **Modifier Group** — a container and policy (e.g. "Cheese Options" with Min 1, Max 1 selection)
2. **Modifier Items** — individual options inside the group (e.g. "No Cheese", "Regular Cheddar", "Extra Cheddar +RM 0.50"), each with its own price and settings
3. **Mappings** — rules that attach the group to products or categories, so those items show on the POS checkout screen
**Why this matters:** A single group like "Cheese Options" can be attached to dozens of products (burgers, pizzas, sandwiches) without duplication. Edit the group once, and the change applies everywhere it's mapped.
**Example flow:**
* Create group: "Cheese Options" (Min 1, Max 1 — customer picks exactly one)
* Add items: "No Cheese" (RM 0), "Regular Cheddar" (RM 0), "Extra Cheddar" (+RM 0.50)
* Map to category: "Burgers" — now every burger in your menu offers these cheese choices
* Map to specific product: "Deluxe Pizza" (on top of any category mapping) — now pizza gets the group too
## Modifier Groups
A **Modifier Group** is a named collection of options. The group defines how many options a customer must or can pick from.
| Field | Required | Description |
| ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Name** | Yes | The group label shown to customers (e.g. `Size`, `Add-ons`, `Cooking Level`, `Cheese Options`) |
| **Description** | No | Internal notes (not shown to customers) — useful for staff reference |
| **Min Selections** | Yes | Minimum number of items the customer must choose. Set to `1` to make the group required; `0` for optional |
| **Max Selections** | Yes | Maximum number of items allowed. Set to `1` for single-select (e.g. Size); higher numbers for multi-select (e.g. Add-ons) |
| **Active** | Yes | Toggle whether this group is available for assignment. Inactive groups remain on existing products but can't be attached to new ones |
Set **Min Selections to 1** for groups where a choice is required (like Size). Set it to **0** for optional add-ons. This controls whether the POS will prompt staff to pick options before completing the order.
## Modifier Items
Once you create a group, the **Modifier Items** tab shows a CRUD table of individual options inside that group. Each item is a choice a customer can make.
| Field | Required | Description |
| -------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name** | Yes | The option label (e.g. `Small`, `Extra Cheese`, `Well Done`, `Salsa`) |
| **Price Adjustment** | No | Additional charge for this option. Positive numbers add to the product's base price; `0` means no extra cost |
| **Max Items** | No | Maximum quantity of this one specific option a customer can add to a single product order (rarely used; typically leave blank or set to `1`). This is different from the group's Max Selections |
| **Active** | Yes | Toggle whether this item is available for selection. Inactive items don't show on the POS menu but remain in the group's history |
**Example items for a "Size" group (Min 1, Max 1):**
* Small — RM 0
* Medium — RM 1.00
* Large — RM 2.00
**Example items for an "Add-ons" group (Min 0, Max 5):**
* Extra Cheese — RM 0.50
* Bacon — RM 1.50
* Avocado — RM 2.00
## Create a Modifier Group
Click **Modifiers** in the left sidebar under Catalog.
Enter the group name (e.g. `Size` or `Cheese Options`), optional description, and set Min and Max selections.
Click **Create Group**. The group detail page opens, and you can see the **Modifier Items** tab. Click **Add Item** to add each option with its price adjustment.
Click **Save** for each item. Once your items are ready, move to the **Mappings** tab to assign the group to products or categories.
## Mappings
After creating a Modifier Group and its items, you need to attach (map) that group to products or categories so it appears on the POS checkout screen. The **Mappings** tab shows how many products currently have this group and lets you bulk-assign or remove it.
### Assign by Category
Assign this modifier group to **every product currently in a selected category** in one action.
**How it works:**
* Choose a category (e.g. "Burgers")
* The group is attached to all existing products in that category at that moment
* New products added to the category later are **not** automatically included — this is a one-time bulk action, not a live rule
* If you add new burgers to your menu, re-run this action or attach the group to individual products
**When to use:** Most modifiers fall here. E.g. assign "Cheese Options" to "Burgers", "Cooking Level" to "Steaks", "Sugar Level" to "Beverages".
### Assign by Product
Assign this modifier group to a hand-picked list of specific products, regardless of their category.
**How it works:**
* Search or multi-select individual products
* The group is attached only to those chosen products
* Useful for fine-grained control when some products in a category shouldn't have the group (e.g. "Vodka Sauce" modifier group applied only to select pasta items, not all pastas)
**When to use:** When you want an exceptions list or when a modifier applies to products scattered across multiple categories.
### Managing Mappings
| Action | What it does |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **View Mapped Products** | Shows every product currently carrying this group, grouped by category. Useful for auditing before making a bulk change or to confirm a previous assignment worked |
| **Unassign Product** | Removes the group from a single product, even if it was originally added via a category assignment. Handy for exceptions (e.g. a bottled drink that shouldn't have "Ice Level") |
| **Unassign Category** | Removes the group from every product in that category in one action |
Category assignment is a one-time bulk action, not a live rule. If you assign "Ice Level" to the Drinks category and later add a new drink, you need to either re-run **Assign to Category** or attach the group to that one product individually.
You can mix and match: assign a group to a whole category, then use **Unassign Product** to remove it from the one or two items that shouldn't have it. The same group can be assigned via both category and individual products — the system deduplicates, so you won't see the group twice on a product.
Bulk assignments in the Mappings tab write to many products at once. Review the category or product list carefully before confirming, especially when using **Unassign Category**.
## Common Examples
| Group | Min | Max | Options |
| ------------- | --- | --- | ------------------------------------------------------------- |
| Size | 1 | 1 | Small (+RM 0), Medium (+RM 1), Large (+RM 2) |
| Add-ons | 0 | 5 | Extra cheese (+RM 0.50), Bacon (+RM 1.50), Avocado (+RM 2.00) |
| Cooking Level | 0 | 1 | Rare, Medium, Well Done |
| Sugar Level | 1 | 1 | 0%, 25%, 50%, 75%, 100% |
| Ice Level | 1 | 1 | No Ice, Less Ice, Normal, Extra Ice |
## Frequently Asked Questions
If **Min Selections** is `1` or more, the modifier group is required — staff cannot complete the order without making a selection. If Min is `0`, the group is optional and staff can skip it. Use required modifiers for choices like Size where there is no sensible default.
**Max Selections** (on the group) — the maximum number of *different items* the customer can pick from this group. E.g. if Max Selections = 3 in an "Add-ons" group with items \[Cheese, Bacon, Avocado], the customer can pick any combination up to 3 items: Cheese + Bacon, or Bacon + Avocado + Cheese, etc. **Max Items** (on an individual item) — the maximum quantity of that *one specific option* they can add. E.g. if Bacon has Max Items = 2, the customer can add Bacon twice in a single order, but that counts as 2 toward the group's Max Selections. In most cases, Max Items is left blank (defaults to unlimited quantity of that item, subject to the group's Max Selections limit). It's rarely needed except for special cases (e.g. limiting a premium topping to 1 per order).
Yes. Create the group once and attach it to as many products as you like. If you update the group (e.g. change a price or add a new item), the change applies to all products that use it.
Yes. Each option can have its own price adjustment. You can also set an option to RM 0 if it has no extra cost.
Yes. Use the **Assign by Product** mode in the Mappings tab to hand-pick specific products, or go to **Menu Builder → Products → Edit → Modifiers** and select the group for that one product. Both approaches work for single-product assignments.
Make sure the group has been attached to that product — either individually under Menu Builder → Products → Edit → Modifiers, or in bulk via **Assign to Category** / **Assign by Product** in the Mappings tab on the Modifiers page. Creating a modifier group does not automatically apply it to any product; it must be mapped.
Category assignment runs once, against the products in the category at that moment. It is not a standing rule. After adding new products to the category, either re-run **Assign to Category** on the group, or attach the group to the new product individually.
## Related
Attach modifier groups to individual products via the Modifiers tab on product edit
Drag-and-drop 3-panel menu layout with inline modifier assignment on product detail
Organise products into categories, then bulk-assign modifier groups to entire categories
Override prices and availability per context (separate from modifier price adjustments)