Platform 2 Guide — This article applies to the new platform. Looking for classic platform docs? Browse the Platform 1 collection.
Why: Clear, familiar amounts help members shop with confidence and buy enough to make every recipe—without turning recipe measurements into unfamiliar package sizes.
Navigate: Meal plan > Shopping List — open a shopping list from a meal plan. Select an ingredient line to view its breakdown.
Quick Start
Open a meal plan’s shopping list.
Find an ingredient line to see its combined amount.
Open the line to view the recipe contributions in its breakdown.
Compare the displayed total with the amounts from each recipe.
Why combined amounts are not raw math
A meal plan may use the same ingredient in several recipes, with different servings and units. The shopping list combines those contributions into one clear line when possible, so members can see what to buy without adding up every recipe themselves.
The displayed amount is designed to be:
Enough to cook: rounding should not leave members short.
Familiar: amounts use practical cooking units and recognizable fractions.
Honest about the recipes: the list avoids inventing a package size the recipes never used.
Why: A shopping list rounds amounts up to a familiar cooking fraction so a small contribution—such as a tablespoon of oil—doesn’t disappear from the total.
How ingredients are combined
Ingredients are combined when they use the same library ingredient and belong to the same aisle. The amounts are scaled to match the servings or yield used in the meal plan, then combined when their units can be brought together.
Ingredients in different aisles remain on separate lines. If the same ingredient appears in units that can’t be combined, the list may show separate lines rather than imply an inaccurate total.
Leftover or portion sessions are excluded because they use food already prepared in another session. Counting those ingredients again would double-count them.
Note: Recipe lines with an ingredient name but no amount can appear as name-only lines. They don’t add a zero amount to a quantified total.
Choosing the display unit
The shopping list favors kitchen measuring units used in the recipes, such as teaspoons, tablespoons, cups, and fluid ounces. It avoids inventing packaging units such as pints, quarts, or gallons when the recipes didn’t use them.
Why: Keeping the amount in the recipes’ kitchen units makes the total easier to measure and avoids suggesting a package size the recipes never specified.
When recipes use more than one kitchen unit, the list generally prefers the largest source kitchen unit. For example, if a total can be shown in cups, it’s more useful to keep it at a cup-scale amount than to display a long count of tablespoons.
Packaging units can still be used when a recipe already used them. For example, if recipes measure cream in pints, the combined amount may remain in pints.
Familiar cooking fractions only
Shopping lists use whole numbers and a short set of familiar cooking fractions:
1/4
1/3
1/2
2/3
3/4
They don’t use finer or less familiar fractions such as 1/8, 5/8, or 7/8. Recipe amounts can be more precise; shopping lists use coarser amounts that are easier to work with while shopping.
Round up so members do not under-buy
When a combined amount falls between the allowed fractions, the shopping list rounds up to the next allowed amount. This can make the displayed amount slightly larger than the exact total, intentionally.
For example, one recipe calls for 1 tablespoon of olive oil and another calls for 1/2 cup. Together, that is exactly 9/16 cup, or 9 tablespoons. The shopping list displays 2/3 cup: 1/2 cup would leave out the tablespoon, and 1/4 pint would introduce a packaging unit the recipes didn’t use.
Count-based items, such as eggs, cans, and cloves, display as whole numbers because members generally can’t buy a fraction of an item. Matching container lines are an exception: when the recipes use the same container size, the list can keep a fractional package count, such as 1 1/2 packages.
The list row and breakdown show the same total
The shopping list line and its ingredient breakdown display the same formatted total. The breakdown also shows the contributing recipe amounts, so members can see how the total was built without seeing a different rounded total in the two places.
Display preferences and free-text extras
Display preferences affect how an amount is written, not how it is combined, which unit is chosen, or how it rounds up. Depending on the app and member preferences, amounts may use fraction characters or slash notation, full unit names or abbreviations, metric or imperial measurements, and unit names in the member’s language.
Free-text extras stay as typed rather than being converted or reformatted.
Tip: For help with pantry items, aisles, and adding manual items, see Shopping Lists.
