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

1

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.

2

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).

3

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.

4

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?

Visual meal building, real-time nutrition, allergen tracking, and dynamic pricing — everything your food business needs on Shopify.

Free plan available · No credit card required · 5-minute setup · 30-day money-back guarantee