Residual Try free
All help topics Your food

Find a food: search, barcode, label, and your food library

Every place you add a food opens the same search. It shows your own foods first, then USDA FoodData Central. When a food isn’t there, photograph its label and it’s yours from then on.

Where search opens

The same search opens from Add food in a meal you’re planning, Add what you ate while logging, Add food in a saved meal, Add ingredient in a recipe, and Add a food on the Pantry tab. Type a name in the field at the bottom. Pick a food and it’s added at a usual amount, which you can change.

What search shows

Your own foods answer from the first letter. USDA joins in once you’ve typed three.

Section What’s in it
Favorite meals Your saved meals, when you’re adding to a meal. Picking one “Adds every food in the meal, at its saved amount.”
My foods Foods you read from a package label, or USDA foods you corrected.
Recipes Your recipes, each one food.
Favorites Foods you saved as favorites.
Pantry The foods in your pantry.
Library Foods you’ve used, newest first, then the built-in foods you haven’t used yet.
Food database USDA. Generic foods such as “Cottage cheese, full fat” first, with Show all … generic foods when there are more, then packaged foods, 50 at a time with Show 50 more.

Each row says where its numbers come from: “USDA generic”, “USDA branded”, “Manually verified”, “Saved food”, “Library”, “Recipe” or “AI estimate”. A USDA row also shows USDA’s own calorie count, such as “USDA says 105 kcal”, beside Residual’s. How the numbers work explains why the two can differ.

Lots of packaged results? The footer says how many there are. Add a brand or another word to narrow them.

Scan a barcode

  1. In search, tap the barcode button at the top.
  2. Point your camera at the barcode.

One match is added straight away. If you’ve saved your own version of a USDA food, both are listed, yours first, and you pick. If nobody knows the barcode, Residual opens Add from the label with the barcode filled in.

Add a food from its label

Most store brands aren’t in USDA. Read the label instead, once.

  1. At the bottom of search, tap Add a food from its label. With a name typed, it reads Can’t find it? Add it from the label.
  2. Tap Photograph the Nutrition Facts, or Choose from Photos. Get the whole panel in frame. A second photo of the barcode or the front of the package helps with the name. The label is read on your iPhone; nothing is uploaded.
  3. Check the fields under Product: the name, the brand and the barcode.
  4. Under Nutrition Facts, per serving, check the serving size (in grams or milliliters) and each number against the package. Turn on Contains alcohol for a drink with alcohol.
  5. Tap Save.

The food saves as “Manually verified” and shows under My foods everywhere search opens. Scanning its barcode or typing its name finds it next time. If the label can’t be read, Food search, barcodes and labels has what to do.

Correcting a USDA food

Open a USDA food in your food library or your pantry, change a number to match your package, and save. It becomes “Matched USDA · User override”: your numbers win, and the USDA match is kept. Scanning that barcode then offers both, yours first.

Your food library

MoreFood library holds everything search offers as your own foods. The buttons at the top filter it:

Filter What it shows
All Everything below.
My foods Foods you read from a label or corrected from USDA, found by name and by barcode.
Used Foods you’ve added to meals.
Built-in Starter foods with typical numbers.

Tap a food to edit its numbers. Editing a used or built-in food saves your own version and doesn’t change past meals. Swipe right to add one to your pantry. Swipe left to remove a used food, which hides it until you use it again, or to delete one of your own or a built-in food for good.

When you change a food’s numbers, meals you haven’t logged yet, today and later, take the change. Logged meals and earlier days stay as they were.

When search doesn’t answer

Offline, or USDA says it’s busy? Your own foods and USDA’s generic foods still work. Food search, barcodes and labels covers each message.