All help topics Troubleshooting
Food search, barcodes and labels
Food search looks in your own foods first, then in USDA FoodData Central. When USDA can’t answer, or a package isn’t in it, there is always another way to get the food in.
You’re offline
Search still works without a connection. It shows the foods you’ve saved, used or put in your pantry, plus USDA’s generic foods, which come with the app. The message reads “You’re offline. Showing your foods and generic foods; USDA search returns when you’re back online.”
Packaged foods need USDA, so most of them wait until you’re connected. Logging and Close the residual don’t need a connection at all.
“The food database is busy”
USDA limits how often it answers. When it says no, search shows “The food database is busy. Try again in a minute; favorites, pantry, and the library still work.”
Wait a minute and search again. Your own foods keep answering in the meantime. If it says “Couldn’t reach the food database” or “The food database isn’t available right now”, the same applies: try again in a minute.
Search asks USDA only once you’ve typed three letters. Your own foods answer from the first letter.
A barcode isn’t found
Tap the barcode button in food search to scan. If neither your foods nor USDA know the barcode, Residual says “Not in the food database — add it from its label.” and opens Add from the label with the barcode filled in. Photograph the package’s Nutrition Facts, check the numbers, and tap Save. The next scan of that barcode finds it.
Offline, a barcode you haven’t saved before goes straight to Add from the label too.
A food that isn’t found by name works the same way: the search shows Add it from the label.
A label can’t be read
On Add from the label, tap Photograph the Nutrition Facts, or Choose from Photos. The label is read on your iPhone; nothing is uploaded.
- “Couldn’t read that photo. Try again with the panel flat and in focus.” Lay the package flat, fill the frame with the whole Nutrition Facts panel, and take it again.
- “Couldn’t read every number — fill in the rest from the package.” Type the missing numbers from the package. Each field is one line of the panel.
A second photo, of the barcode or the front of the package, helps with the name. Whatever was read, check each number against the package before you save. The food saves as Manually verified.