Nutrition & Allergen Tracking
Nutrition that builds trust
Real-time calorie, macro, and allergen calculations update instantly as customers customize their order. Seven nutrients tracked, three display formats, and dietary evaluation — all calculated client-side with zero server round-trips.
Health-conscious customers leave without data
Your customers want to know what they’re eating. Calorie counts, macros, allergen warnings — this information drives purchasing decisions for health-conscious consumers. Without transparent nutrition data on your customization widget, you lose the fastest-growing customer segment in food retail. Manual nutrition labels don’t update when customers change their order.
How Nutrition Tracking works
Enter nutrition data per ingredient
Add a serving size (value + unit), seven nutrient values (calories, protein, fat, carbs, fiber, sugar, sodium), allergen tags as comma-separated strings, and dietary properties per option. Bulk CSV import supports up to 100 ingredients at once.
Choose your display format
Select from three display formats in Merchant Settings: summary (compact inline showing calories and macros), full (detailed card grid with all nutrients), or FDA label (nutrition facts format with daily value percentages based on a 2,000-calorie diet).
Configure allergen warnings
Enable allergen warning display, set highlight severity levels, and define your severe allergens list. Allergens are aggregated from all selected options using Set-based deduplication — no duplicate warnings.
Customers see live nutrition as they customize
Nutrition values update in real time as customers add or remove options. Values are quantity-aware — selecting 2x of a protein doubles all nutrient values. Dietary tags use intersection logic: a meal is only tagged “vegan” if every selected option supports it.
Why merchants choose Nutrition Tracking
Build customer trust
Transparent nutrition data converts health-conscious customers. When customers can verify calories, macros, and allergens before ordering, they buy with confidence.
Zero-latency calculation
All nutrition math happens client-side with no server round-trip. Calories, macros, and allergens update instantly as customers interact with the customizer.
FDA-format nutrition labels
Display nutrition data in the familiar FDA Nutrition Facts format with daily value percentages calculated against standard references: 2,000 calories, 25g fiber, 2,300mg sodium.
Dietary evaluation built in
Automatic vegetarian, vegan, gluten-free, and dairy-free evaluation using intersection logic. Customer profiles support eight dietary preferences including halal, kosher, and low-sodium.
Under the hood
Seven nutrients tracked
Calories, protein, fat, carbohydrates, fiber, sugar, and sodium. Each is stored per ingredient in the NutritionModel with a name, serving size (value + unit), seven nutrition fields, an allergens array, and a dietary properties object. The schema is extensible via [key: string] for future nutrients.
Quantity-aware calculation
Nutrition values are multiplied by the option quantity selected. If a customer adds 2x of a protein, all seven nutrient values double. Final values are rounded to one decimal place. Allergens are aggregated from all selected options via Set-based deduplication to prevent duplicate warnings.
Dietary intersection logic
Evaluation starts with four dietary tags enabled: vegetarian, vegan, gluten-free, and dairy-free. For each selected option, if the option has a dietary tag set to false, that tag is removed. The result is an intersection — a meal is only tagged “vegan” if all selected options are vegan.
FDA daily value percentages
Fat: 9 calories per gram against a 2,000-calorie daily reference. Carbs and protein: 4 calories per gram against 2,000 calories. Fiber: against 25g daily. Sodium: against 2,300mg daily. These percentages are displayed in the FDA nutrition facts label format.
Caching and bulk operations
Ingredient queries are cached in Redis with a 600-second TTL, invalidated on mutations. Bulk CSV import supports up to 100 ingredients per upload with success/failure counts and error detail reporting. The storefront block setting controls whether nutrition info is displayed.
Ready to transform your food business?
Join food businesses using FoodFlex to increase order value by 23%, reduce errors by 87%, and delight their customers.
Free plan available · No credit card required · 5-minute setup · 30-day money-back guarantee