Use the Menu Validator to scan your entire menu for menu setup issues before syncing menu updates to stores. Menu Validator checks your menu against 18 validation rules and organizes findings by severity so you can fix problems before they affect your POS. You can
Run the Menu Validator
Use the Menu Validator page in Menu Editor to scan for issues before syncing to stores. Follow the steps below to open Menu Validator.
Steps:
From RM, click Manage > Menu Manager and enter the Menu Editor for the menu you want to validate.
Click the three-dot menu (⋮) icon in the top-right corner of the menu editor page.
Select Menu Validator from the dropdown. The Menu Validator page opens.
Note: Menu Validator is accessed from the three-dot overflow menu in the editor, not from the left navigation sidebar. The Sync To Stores sidebar item is separate and remains unchanged.
You can click Re-Scan in the top-right corner of the card. The system checks all 18 validation rules again and refreshes the results.
Note: If no issues are detected, the page displays the message "Your menu is safe to sync", which means the menu is ready to sync to stores.
Reading the Results
Use the results to review detected issues. Each row represents one validation finding. Follow the steps below to filter and review results.
Steps:
From RM, click Manage > Menu Manager and enter the Menu Editor.
Open Menu Validator from the three-dot menu (⋮) and run a scan.
Review the results table. Each row includes the following columns:
Column | Description |
| Rule | The name of the validation check that detected the issue |
Severity | How critical the issue is — Error, Warning, or Info (color-coded) |
| Entity Type | The type of menu record affected (e.g., Item, Modifier, Group, Time Price) |
| Name | The name of the specific affected record — click to jump directly to it in the editor |
| Group | The menu group the affected record belongs to, where applicable |
| Details | A short description of what was detected and why it may be a problem |
Use the filter chips at the top — All, Errors, Warnings, Info — to focus on a specific severity level. Each chip displays the count of issues in that category.
Click the Severity column header to sort results by severity level.
Use the rows-per-page control at the bottom to show 10, 25, 50, or 100 results at a time. Use the forward and back arrows to navigate between pages.
Note: There are three severity levels.
Errors (red) must be resolved before syncing — they will cause a sync failure or incorrect charges at the POS.
Warnings (amber) should be reviewed before syncing — the menu will sync, but something may not work correctly at the POS.
Info (blue) are cleanup items with no immediate operational impact and can be addressed at your convenience.
Navigating to an Issue
Click any item name in the results table to jump directly to that record in the menu editor. Follow the steps below to navigate to an affected item.
Steps:
From RM, click Manage > Menu Manager and enter the Menu Editor.
Open Menu Validator from the three-dot menu (⋮) and run a scan.
In the results table, click the Name of the affected record. The editor opens directly on that item, modifier, group, or other entity so you can make corrections immediately.
After making corrections, return to Menu Validator and click Re-Scan to confirm the issue has been resolved.
Fixing Issues Automatically
Use the Fix Issues button to automatically resolve certain common issues with a single click. Follow the steps below to run an auto-fix.
Steps:
From RM, click Manage > Menu Manager and enter the Menu Editor.
Open Menu Validator from the three-dot menu (⋮) and run a scan.
Click Fix Issues in the top-right corner of the card.
A confirmation banner displays, showing how many issues were automatically resolved and how many require manual attention.
The results table automatically refreshes to reflect the updated state of your menu.
Note: Not all issues can be auto-fixed. Issues that require a manual decision, such as choosing the correct price when duplicates exist, will remain in the table after clicking Fix Issues and must be resolved by editing the menu directly.
See the Validation Rules Reference below for which issues are auto-fixable.
Validation Rules Reference
Menu Validator checks against 18 rules across three severity tiers. Use the reference below to understand what each rule detects and how to resolve it.
Errors: Resolve before syncing to stores
Rule | Applies To | What It Detects | How to Resolve | Auto-Fix? |
Duplicate Pricing | Items, Modifiers, Styles, Store Overrides | The same item or modifier has two conflicting prices for the same size. The POS cannot determine which price to charge. | Remove the duplicate pricing row, keeping only the correct price. | No |
Duplicate Excluded & Preselected | Modifiers | A modifier has duplicate assignment rules for the same item. This causes a menu sync failure. | Click Fix Issues — the system automatically keeps the most recently updated assignment and removes duplicates. | Yes |
Trailing Whitespace in Name | Groups, Size, Style, Items, Modifiers, Preference | An item, modifier, or group name has a space at the beginning or end. This causes a sync failure because the POS and the menu platform disagree on the name value. | Click Fix Issues — the system automatically trims the extra spaces from all affected names. | Yes |
Orphan Assigned Preference | Items | An item references a preference that has been deleted or made inactive. This causes an error during sync. | Open the affected item, remove or replace the inactive preference assignment, and save. | No |
Warnings: Review before syncing to stores
Rule | Applies To | What It Detects | How to Resolve | Auto-Fix? |
Missing Required Modifier | Items | An item is configured to require modifiers, but no active modifier categories are assigned to it. | Open the affected item and assign the appropriate required modifier category. | No |
Items Without Pricing | Items | An active menu item has no pricing configured. The item will appear on the POS with no price. | Open the affected item and add pricing in the Pricing section. | No |
Duplicate PLU Codes | PLU Codes | Two menu records share the same PLU code. This can cause the POS to insert both records for the same code. | Assign a unique PLU code to one of the affected records. | No |
Empty Groups | Groups | A menu group is active but contains no active items. It will appear as an empty group on the POS. | Either add items to the group or deactivate the group if it is no longer needed. | No |
Invalid Preselected Modifiers | Modifiers | A modifier is set as preselected but is not included in the item's required modifier list. | Open the affected modifier and correct the preselect configuration, or update the item's required modifier assignments. | No |
Invalid Size Exclusions | Items, Modifiers, Styles | A size exclusion rule references a size that belongs to a different group or is inactive. | Open the affected record and remove or correct the invalid size exclusion. | No |
Unpriced Preference Members | Preferences | A preference member has no pricing configured. | Open the affected preference and add pricing for the member. | No |
Time Pricing Overlap | Time Prices | Two time-based pricing windows overlap for the same item and size. This creates ambiguous pricing behavior at the POS. | Open the affected time prices and adjust the start and end times so they do not overlap. | No |
Empty Modifier Categories | Modifier Categories | A modifier category has no active modifiers. Shown as a Warning if an active item requires this category; shown as Info if no items are affected. | Add active modifiers to the category, or remove the requirement from items that reference it. | No |
Empty Preferences | Preferences | A preference has no active members. Shown as a Warning if an active item is assigned to this preference; shown as Info if no items are affected. | Add members to the preference, or remove the preference assignment from items that reference it. | No |
Info: Cleanup items, no immediate operational impact
Rule | Applies To | What It Detects | How to Resolve | Auto-Fix? |
Orphan Modifiers | Modifiers | A modifier exists but has no pricing and is not assigned to any item. It is unused data. | Click Fix Issues to remove unpriced orphan modifiers automatically, or delete the modifier manually. | Yes (partial) |
Orphan Production Items | Production Items | A production item is not linked to any menu item. | Link the production item to the appropriate menu item, or delete it if no longer needed. | No |
Unused Time Prices | Time Prices | A time price is active but not applied to any menu item or size. | Click Fix Issues to automatically deactivate unused time prices, or delete them manually. | Yes |
Orphan Store Overrides | Store Price Overrides | A store-level price override points to a base price that has been deactivated. The override has no effect. | Click Fix Issues to automatically remove orphan store overrides, or delete them manually. | Yes |
Note: Empty Modifier Categories and Empty Preferences appear as a Warning when an active item depends on them, and as Info when no items are affected. Check the Details column in the results table for context.
Comments
0 comments
Article is closed for comments.