Skip to Content
TroubleshootingAllergen Sync Issues

Allergen Sync Issues

Troubleshoot problems with derived allergens and allergen propagation.

Understanding Derived Allergens

Allergens “derive” from:

  • Ingredients → Items
  • Combo components → Combos
  • Variant options → Variant parents

When source changes, derived items should update.

Common Issues

Parent Not Showing Correct Allergens

Symptom: Combo or variant parent doesn’t show allergens from components.

Causes:

  1. Component allergens not set
  2. Component not properly linked
  3. Cache not refreshed

Fix:

  1. Verify component has allergens marked
  2. Check component is linked correctly
  3. Edit and save parent to refresh
  4. Wait 1-2 minutes for cache

Allergens Not Updating After Change

Symptom: Changed allergen on ingredient/item but parent unchanged.

Causes:

  1. Cache not refreshed
  2. Override exists on parent
  3. Change not saved

Fix:

  1. Wait 2 minutes for cache refresh
  2. Edit parent and save (forces refresh)
  3. Check for overrides on parent
  4. Verify source change was saved

Too Many Allergens Showing

Symptom: Item shows allergens it shouldn’t have.

Causes:

  1. Ingredient has wrong allergens
  2. Linked to wrong item
  3. Override set incorrectly

Fix:

  1. Check each ingredient’s allergens
  2. Verify item links
  3. Review and remove overrides

Too Few Allergens Showing

Symptom: Item missing expected allergens.

Causes:

  1. Ingredient allergens not set (Unconfirmed)
  2. Component not linked
  3. Derivation error

Fix:

  1. Mark allergens on source items
  2. Check all components are linked
  3. Contact support if issue persists

Checking Derivation

View Allergen Source

  1. Open the item
  2. Go to Allergens tab
  3. Look for “Derived from” indicators
  4. See which components contribute which allergens

Trace the Chain

For complex items:

Combo Meal
├── Burger (Wheat, Milk) ← Where did these come from?
│   ├── Bun (Wheat) ✓
│   └── Cheese (Milk) ✓
├── Fries (None)
└── Drink (None)

Derived: Wheat (from Burger), Milk (from Burger)

Manual Override Issues

Override Not Working

Symptom: You override but derived value returns.

Cause: Override may not be saved properly.

Fix:

  1. Open item
  2. Click override option explicitly
  3. Confirm “Override derived value”
  4. Save

Can’t Remove Override

Symptom: Want to return to derived value.

Fix:

  1. Open item
  2. Find the overridden allergen
  3. Click “Reset to derived”
  4. Save

Don’t Know If Overridden

Check:

  1. Open item
  2. Allergens tab
  3. Overridden values show indicator
  4. “Derived” vs “Manual” label

Cache Problems

Stale Allergens

Symptom: Changes not reflecting anywhere.

Fix:

  1. Wait 2 minutes
  2. Hard refresh browser (Ctrl+F5)
  3. Edit and save affected items
  4. Check again

Inconsistent Display

Symptom: Different values in different places.

Cause: Cache out of sync.

Fix:

  1. Wait for cache to expire
  2. Force refresh by editing
  3. Clear browser cache

Combo-Specific Issues

Component Removed But Allergens Remain

Symptom: Removed component’s allergens still showing.

Cause: Cache not updated.

Fix:

  1. Wait 2 minutes
  2. Edit and save combo
  3. Verify allergens updated

Choice Options Not Included

Symptom: Combo not showing allergens from choice options.

Expected: Combo shows ALL possible allergens from ALL options.

Check:

  1. Choice options have allergens set
  2. Options are properly linked to choice group
  3. Choice group is linked to combo

New Component Allergens Not Added

Symptom: Added component but its allergens don’t appear.

Fix:

  1. Verify component has allergens set
  2. Component must be saved
  3. Combo must be saved
  4. Wait for cache refresh

Variant-Specific Issues

Option Allergens Not on Parent

Symptom: Variant option has allergen, parent doesn’t show it.

Check:

  1. Option is properly linked
  2. Option allergens are marked (not Unconfirmed)
  3. Parent cached allergens refresh

Fix:

  1. Verify option linkage
  2. Mark allergens on options
  3. Edit and save parent

Removed Option Allergens Persist

Symptom: Removed option’s allergens still on parent.

Cause: Cache not updated.

Fix:

  1. Wait for cache refresh
  2. Edit and save parent
  3. Verify allergens updated

Diagnostic Steps

Check Source Items

  1. List all components/options
  2. For each, verify allergens set
  3. Ensure not all Unconfirmed
  4. Fix any gaps
  1. Open parent item
  2. Verify all links intact
  3. Re-link if broken
  4. Save changes

Force Refresh

  1. Edit the parent item
  2. Make any small change
  3. Save
  4. Check allergens

Clear All Caches

  1. Log out
  2. Clear browser cache
  3. Log back in
  4. Check again

When to Contact Support

Contact support if:

  • Derivation logic seems wrong
  • Changes never reflect after 5+ minutes
  • Error messages appear
  • Data seems corrupted

Include:

  • Item names affected
  • Expected vs actual allergens
  • Steps you’ve tried
Last updated on
QR Code Not WorkingImport Problems