Modifier Categories
Use this page to add and manage modifier categories — groups that organise modifier options (for example “Sauces”, “Toppings”, or “Size upgrades”). Set whether choices are mandatory, single or multi-select, and how many modifiers a customer can pick.
Open the screen: Sidebar → Master Data Management → Modifiers Categories
Create categories before modifiers
Set up modifier categories here first. Then add individual modifier lines under Modifiers and attach them to menu items.
Modifier categories list
What it does
Shows all modifier categories with selection rules, display order, and status. Filter the list, reorder rows, then add, view, or edit categories.
Step-by-step
- Open Master Data Management → Modifiers Categories.
- Wait if the table shows Loading modifier categories….
- Use filters to narrow the list (see table below). Name and sequence searches update shortly after you stop typing.
- Read the table — drag handle, ID, Modifier Category, Is Mandatory, Is Single Select, Seq No, Max, Status, and Actions.
- Tap the refresh button (circular arrow) to reload the list.
- Use pagination at the bottom to change page or rows per page.
Filters
| Filter | What it does |
|---|---|
| Category Name | Search by category name. Tap X to clear. |
| Sequence Number | Filter by display order number. Tap X to clear. |
| Status | Show All, Active, or Inactive (defaults to Active) |
What the table shows
| Column | Meaning |
|---|---|
| Drag handle | Grip icon — drag a row to change display order |
| ID | Modifier category record ID |
| Modifier Category | Category name (for example “Extra toppings”) |
| Is Mandatory | Yes if customers must pick from this group; No if optional |
| Is Single Select | Yes if only one modifier allowed; No for multiple selections |
| Seq No | Display order — lower numbers appear first |
| Max | Maximum modifiers a customer can pick — shows - when not set |
| Status | Active (green) or Inactive (red) badge |
| Actions | View (eye) and Edit (pencil) |
Find inactive categories
Set Status to All or Inactive to see categories you turned off.
Common mistakes / FAQs
- I see “No modifier categories found”. No row matches your filters. Clear the search fields or set Status to All.
- I do not see Add New, Import, or Edit. Ask your administrator for CREATE or UPDATE permission on Modifiers Categories.
Add a modifier category
What it does
Creates a new modifier group with selection rules and active status.
Step-by-step
- Tap Add New.
- In the Add Modifier Category dialog, enter Category Name.
- Enter Maximum — the highest number of modifiers a customer can pick from this group.
- Toggle Active on or off (defaults to on).
- Toggle Mandatory on if customers must choose from this group.
- Toggle Single Select on if customers may pick only one modifier in this group.
- Tap Create.
- When successful, you see a success message and the dialog closes. The new row appears in the table.
Modifier category fields
| Field | Required? | What to enter |
|---|---|---|
| Category Name | Yes | Group name (for example “Sauces”) — up to 255 characters |
| Maximum | Yes* | Highest number of modifiers allowed — hidden when Single Select is on |
| Active | No | Toggle on for Active, off for Inactive |
| Mandatory | No | Toggle on if the customer must pick from this group |
| Single Select | No | Toggle on to allow only one choice — Maximum is set to 1 automatically |
* Maximum is not shown when Single Select is on — the limit is always 1.
Single select vs multi-select
Turn Single Select on for groups like “Choose your bread”. Leave it off and set Maximum higher for groups like “Pick up to 3 toppings”.
Common mistakes / FAQs
- “Category name is required”. Enter a name before you tap Create.
- Maximum field disappeared. Single Select is on — only one modifier is allowed. Turn it off to set a higher Maximum.
View a modifier category
What it does
Opens a read-only view of a modifier category’s settings without changing anything.
Step-by-step
- In the table, tap View (eye icon) on the row.
- The dialog title shows View Modifier Category. Fields are not editable.
- Review Category Name, Maximum, Active, Mandatory, and Single Select.
- Tap Close.
No separate view page
There is no full-screen view. To read details without saving, open View and close the dialog instead of Edit.
Edit a modifier category
What it does
Updates an existing modifier category’s name, selection rules, or status.
Step-by-step
In the table, tap Edit (pencil icon) on the row.
In the Edit Modifier Category dialog, change the fields you need.
Tap Update.
When successful, you see a success message and the dialog closes.
Tap Reset to undo unsaved changes on the form.
Common mistakes / FAQs
- Edit is disabled. Ask your administrator for UPDATE permission on Modifiers Categories.
- “Your session has expired”. Sign in again and retry.
Reorder modifier categories
What it does
Changes the display order of modifier categories. Lower Seq No values appear first when modifiers are shown on POS and online ordering.
Step-by-step
- In the table, find the row you want to move.
- Drag the grip handle on that row up or down.
- Drop the row in the new position.
- Wait for the success message — the new order saves to the server automatically.
Reorder on one page at a time
Pagination shows one page of categories. Change Records per page if you need to move items across pages.
Common mistakes / FAQs
- “Reordering Failed”. Refresh the list and try again.
Deactivate a modifier category
What it does
Hides a modifier category from active use without deleting its record.
Step-by-step
- Tap Edit on the category row.
- Toggle Active off.
- Tap Update.
Inactive categories stay linked
Turning a category Inactive does not remove modifiers or item links already using it. Review linked modifiers under Modifiers and your item setup if you retire a group.
Import modifier categories from CSV
What it does
Creates many modifier categories at once from a spreadsheet file.
Step-by-step
- Tap the Upload icon next to Add New.
- Wait while the import dialog loads module types.
- Drag a CSV file into the upload area, or tap to browse and select one.
- Review the selected file name and size.
- Tap Import Modifier Categories.
- When successful, you see a success message. The dialog closes and the list refreshes.
Download a blank template: Modifier Categories import template (CSV)
CSV column format
| Column | Accepted header names | Notes |
|---|---|---|
| Category name | modifier_category, name, or category_name | If missing, a placeholder like Category 1 is used. |
| Status | status | Active, 1, or numeric 1 → active; anything else → inactive. |
| Sequence number | seq_no or sequence | Integer; defaults to row order (1, 2, 3…). |
| Mandatory flag | is_mandatory | 1 = yes; anything else = no. |
| Single select flag | is_single_select | 1 = yes; anything else = no. |
Use UTF-8 for special characters
Save the CSV as UTF-8 if category names include accents or non-English characters.
Common mistakes / FAQs
- “Please select a valid CSV file.” Only
.csvfiles are accepted. - Import failed after upload. Read the error toast for server validation details. Fix the CSV and import again.
Permissions
| What you need | Why |
|---|---|
| Modifiers Categories module permission | See the Modifiers Categories menu and list |
| CREATE on Modifiers Categories | Tap Add New or Import |
| UPDATE on Modifiers Categories | Tap Edit or reorder rows |