Menu Push Failure Error on Checkmate Portal – Checkmate

Menu Push Failure occurs when Checkmate cannot successfully push updated menus from the Checkmate Portal to online ordering platforms. This may result in:

Outdated menus
Customer complaints
Failed or missed orders

After each push, you’ll receive an email notification indicating whether the update was:

Fully Successful
Partially Failed
Fully Failed

To manage your email preferences, see: Menu Push Notification Preferences

This article outlines the most common causes of menu push failures, how to resolve them, and who to contact when support is required.

Modifier Min–Max Settings

Error Message	Explanation	Resolution	Support Needed?
Modifier group 'Element_name (Element_ID)' is required, but all modifiers are marked as sold out.	A required modifier group (min = 1) has no available options.	Either mark the parent item as Out of Stock, or ensure one modifier is available. Then reattempt the push.	No – Resolve in POS or Checkmate Portal

Pricing

Error Message	Explanation	Resolution	Support Needed?
Element has a price $0 or negative.	Most platforms don’t accept $0 or negative pricing.	Update to a valid positive price in POS.	No – Resolve in POS*
pickup_price is null (DoorDash)	DoorDash requires a pickup price for every item.	Assign a pickup price in POS.	No – Resolve in POS*
Price exceeds platform limits	Platforms like UberEats reject items priced over $375.	Lower the price in POS, then push again.	No – Resolve in POS*

*Some Brands require that updated prices are fetched from their POS and pushed to the Ordering Platform menus by Checkmate's Support Team. If you're unsure whether this is required for your brand, please contact Support.

Tax Rate

Error Message	Explanation	Resolution	Support Needed?
Tax rate is missing or 0%	Platforms require a defined tax rate to process orders.	Assign a valid tax rate (0.01%–50%) in POS.	No – Resolve in POS

Menu Item / Modifier Naming Issues

Error Message	Explanation	Resolution	Support Needed?
Duplicate modifier/item names found	Duplicate names may prevent proper mapping.	Make all names unique in POS or Checkmate Portal.	No – Resolve in POS or Checkmate Portal
Modifier group name too long	Names over 99 characters may be rejected.	Shorten modifier group names to under 99 characters.	No – Resolve in POS
Duplicate item/modifier IDs	Multiple elements share the same backend ID.	Assign unique IDs in POS, then retry push.	No – Resolve in POS
Modifier disambiguation failure	Identical modifiers in different groups cause conflicts.	Rename modifiers or separate them into unique groups.	No – Resolve in POS

Platform-Specific Failures

Error Message	Platform	Explanation	Resolution	Support Needed?
MenuCreate Failure (shared option_id)	DoorDash	Old and new menus using same IDs can conflict.	Delete old menu from DoorDash, then push again.	No – Resolve in Ordering Platform. If needed, contact DoorDash Support for assistance.
Invariant violation: null pickup_price	DoorDash	Missing price field in DoorDash payload.	Set pickup_price in POS.	No – Resolve in Ordering Platform. If needed, contact DoorDash Support for assistance.
400 Bad Request: multiple special hours	Grubhub	Duplicate/overlapping special hours are not allowed.	Remove overlapping special hours or adjust in POS.	Yes – Contact Checkmate Support Include: Brand name, location ID, error message
Too many category duplicates	ChowNow	ChowNow allows a max of 5 categories with the same name.	Rename or consolidate duplicate categories in POS.	No – Resolve in POS. If needed, contact ChowNow Support for assistance.

Authorization & Integration Issues

Error Message	Explanation	Resolution	Support Needed?
401 Unauthorized / 403 Forbidden	Token is missing, expired, or lacks permission.	Reauthorize integration or verify credentials.	Yes – Contact Checkmate Support Include: Brand name, location ID, affected platform

Data Integrity Issues

Error Message	Explanation	Resolution	Support Needed?
Unexpected token / JSON parse error	Malformed data in menu export.	Have support or onboarding review the menu structure.	Yes – Contact Checkmate Support Include: Brand name, location ID, error message

Menu Complexity & Configuration

Error Message	Explanation	Resolution	Support Needed?
Frequent push failures in large menus	Menus with complex modifier structures or high volume may fail more often.	Streamline menu: reduce redundancy, validate data, test in segments.	No – Resolve in POS or Checkmate Portal

Need Help?

If you're still seeing errors after following the steps: Submit a Support Request and Include:

Brand name
Location ID
Full error message
What you’ve already tried