All help topics Your food
Match AI estimates to real foods
A food a planner named is an AI estimate until you match it to a real food. Matching swaps the guess for real numbers, so the day is sized on what the food actually holds. You match a food once, and Residual keeps it.
What “to match” means
When Claude or Apple Intelligence plans a day, it names foods and amounts. A food it took from your pantry, your saved meals or foods you’ve used already has real numbers. A food it named on its own carries the planner’s estimate of its nutrition, marked AI estimate.
Estimates are close, but they’re guesses. Matching links the food to its USDA entry, or to a food of your own, so the plan and the log use real numbers. Nothing is matched behind your back: you pick each match.
Where you’ll see it
- On Today: under the ring, a line such as “2 foods are AI estimates” with Match beside it. A meal row says how many of its foods are still to match, for example “2 to match”.
- In a meal: each food has a line under it saying where its numbers come from. An estimate reads “AI estimate — tap to match the real food”.
- In a plan you’re reviewing: “All 15 foods are AI estimates — match them after you accept.” Or, when most came from your own foods, how many matched and that the rest are estimates.
Match one food
- Open the meal and tap the food’s line, “AI estimate — tap to match the real food”.
- Search opens with the food’s name filled in. Pick the right entry: your own foods first, then USDA.
The line then reads “Matched · USDA”, with the brand when it has one. Tap it again any time to pick a different match.
Match several at once
Tap Match under the ring on Today, or Match 3 foods to USDA in a meal you’re planning. Match foods opens with a row for each estimate.
- Each row shows the food’s numbers now and the closest USDA food by name, with its numbers per 100 g. A suggestion starts switched on only when its calories agree with the estimate.
- Check each one is what you’ll eat. Tap Change… to pick another, or switch it off to leave the estimate. A row that found nothing says “No close match found.” and offers Search….
- Tap Match 3 foods at the bottom (with your own count).
Matching swaps an estimate for USDA’s numbers, so the day’s totals can change. If that moves the day off, Today offers Close the residual.
Your pantry has the same thing: Match 4 items to USDA at the top of the Pantry tab matches pantry foods that aren’t matched yet, and the match stays on each item.
What matching carries
- A match made in the plan carries into the log when you log the meal.
- A match is kept for next time, so the same food in later plans uses it.
- A food that’s still an estimate when you log it logs as an estimate. The meal says how many will, before you tap Log meal.
Where a food’s numbers come from
Every food shows where its numbers come from.
| Label | What it means |
|---|---|
| Matched · USDA | From USDA FoodData Central. Search rows say “USDA generic” or “USDA branded”. |
| Manually verified | Read from the package’s own label by your phone, and checked by you. |
| Matched USDA · User override | A USDA food you corrected from your package. Your numbers win; the USDA match is kept. |
| Saved food | A food saved or entered by hand. |
| Library | One of Residual’s built-in foods, with typical numbers. |
| Recipe | One of your recipes, worked out from its ingredients. |
| AI estimate | A planner’s guess. Match it to a real food so the day is sized on real numbers. |
Residual explains Matched · USDA, Manually verified, the override and AI estimate under MoreHelpHow are the numbers worked out?. To add a food that isn’t in USDA at all, read it from its label: see Find a food.