Help
Foodplanner – User guide
This guide gives you all the important information about Foodplanner.
The quickest way to an explanation: don't know what an icon means? Press and hold it briefly. The app then tells you what it's for.
One more thing: Foodplanner works without a user account. You don't have to create an account or sign in to the app. All the meals you create stay on your phone. Foodplanner only goes online when you import a recipe from a link yourself, and for the full version via Google Play. Installation and updates also run through the Google Play Store. You can read more in the privacy policy (in the settings under “Help”).
1. How Foodplanner works
Foodplanner answers an everyday question: what shall I cook today?
How Foodplanner picks at random: you enter your meals once, along with their ingredients. After that, the app suggests a meal at random. Meals you've eaten recently aren't suggested for a while. And the other way round: the longer it's been since you had a meal, the sooner it comes up again.
Step by step:
- On the “Suggestion” page, the app suggests a meal.
- Like it? Then add it to any day. The ingredients go onto your shopping list automatically.
- On the “Plan” page you see the week and mark what you've eaten. That's how the app knows what you've just had. Without this, the random pick doesn't work.
2. Getting started
The very first time you open it, Foodplanner asks how many people you usually cook for; “Continue” saves the number.
When you first open the app, it's empty. You have two options:
- The “Add sample meals” button adds ten popular meals automatically, with ingredients, amounts and instructions, gathered in the collection Classics. That lets you try the app straight away. You can find more meals in the meal packs (section 8).
- With the “Add first meal” button you enter your own favourite meals right away.
As soon as the app suggests a meal for the first time, a short tour of the suggestion page starts. You can repeat it in the settings with “Show quick tour”.
How many meals make sense? It's best to start with ten to twenty. With only three or four meals, the random pick doesn't work very well.
Good to know: in the free version you can add up to 20 meals. With the full version there's no limit (section 19).
3. The areas of the app
At the bottom you'll find the four areas:
- (Cutlery) Suggestion: What shall I cook today?
- (Calendar) Plan: What's on which day, and what has been eaten?
- (List) Meals: Contains all your meals.
- (Basket) Shopping: Your personal shopping list.
You'll find the settings on the “Plan” page via the three dots at the top right.
4. Suggestion
The suggestion page shows you a meal with its photo, category, cooking time, your rating and when you last ate it. Tap the card to open the meal.
Below it there are three buttons:
- “Add to today” adds the meal to the next free day. If today is already taken, the button says “Add to tomorrow” or names a date (for example “Add to Wed 30 Sep”). The ingredients go onto your shopping list automatically. After that, the list of the next few days opens. There you can tap more days, for instance if you cook ahead for several days. You can also deselect a marked day there. “Done” closes the list. The meal stays on the suggestion page.
- “Roll again” suggests a different meal. You never get the same meal twice in a row. If no other meal fits, it stays and the app tells you “This is the only meal that fits right now”.
- “Skip today” suggests a different meal. The skipped meal isn't shown again today and comes up less often for a week after that. Handy if you're missing ingredients or just don't fancy it.
If you deselect all the days in the list again, the ingredients disappear from the shopping list too.
Below the days you'll see “for 2 · change” – tap it if you're cooking for more or fewer people this time.
If the next seven days are already planned, it says “The next 7 days are planned”. “Roll again” then becomes the main button.
Filters
At the top you'll find the “Category” and “Cooking time” filters. Use them to narrow down the suggestions, for example to vegetarian meals or a short cooking time. Vegan meals also appear when you choose “Vegetarian”. The round button next to them resets the filters.
If no meal fits at the moment, it says “No meal matches”. Below that you can lift the chosen filter directly: “Remove category filter”, “Remove cooking time filter” or “Reset all filters”.
Top right
Two icons take you to fridge mode (section 12) and to the stats (section 13).
Next to the title there's a small flame with a number. That's your streak (section 14).
5. How does the app choose?
The choice is random, but some options are favoured. What you ate last isn't suggested to you for a while. And the other way round too: the longer it's been since you had a meal, the more likely the app is to suggest it again. In addition:
- On cooldown: A meal you've eaten isn't suggested for seven days.
- Rating: Meals with a good rating (4–5 stars) come up a little more often. Meals with a poor rating (1–2 stars) come up a little less often. Three stars is neutral.
- Skipping: The meal doesn't come up again today and comes up less often for a week after that. In the meal, you can take this back via the three dots with “Undo skip”.
- Deactivated: The meal isn't suggested at all until you reactivate it.
What's the difference between on cooldown and deactivated?
You deactivate a meal yourself. It stays that way until you undo it.
The app puts a meal on cooldown because you've just eaten it. After seven days it's available again automatically. You can still plan any meal by hand at any time.
You can see where a meal stands in the meal under “Status”: “Last eaten”, “Cooldown” and “Chance when rolling” (on cooldown, low, medium or high).
6. Plan
The plan shows the last four weeks to look back on, a coloured “Today” line and the next two weeks. When you open it, “Today” is at the top. If you've scrolled away, the “Today” button takes you back.
Filling a day
Tap a free day and choose a meal (“Free – choose a meal”). With “Cancel” at the top right or the back gesture you return to the plan without choosing. The ingredients move onto your shopping list automatically. You can plan the meal you've chosen for one day or several.
Plan week
With the “Plan week” button, the app rolls several random meals at once. First you set how many there should be from each category. Under each category you can see how many meals are available for it right now (not deactivated and not on cooldown), and you can't set a higher number there. The numbers depend on each other and change straight away with your choice: vegan meals also count as vegetarian, so if you set one vegan meal, “Vegetarian” has one fewer available. “All categories” gets whatever the other rows leave. If a number is then above what is still available, the app lowers it to that. Above that you choose between 7 and 14 days: that is how many days from today the app offers for assigning, skipping days that are already taken. It remembers your last choice. Then you tap “Roll … meals” (the button names the number you chose). On the “Assign meals” page you then spread the rolled meals across the free days. You do this by dragging or tapping (“Tap to choose a day”).
- The dice icon next to a meal swaps just that one, never for the same meal.
- “Reroll all” rolls all the meals again. The previous ones only come back if not enough other meals fit.
- “Apply plan” enters everything and puts the ingredients on the shopping list automatically.
One meal for several days
Do you cook ahead on Monday and eat it until Wednesday? Then plan the meal for all three days. The plan shows the same meal on consecutive days on one shared card with all the days in it. The ingredients are only added to the shopping list once.
The ingredients belong to all of these days together. They only disappear from the shopping list when you clear the last of these days.
The cooldown starts on the last day you ate it.
Changing a planned meal
Tap a planned meal. Then you can choose between:
- “Open meal”
- “Move to another day” (for a single day): You choose another day from a list, from today up to two weeks ahead. If it's free, the meal moves there. If there's already a meal on it, the two swap their days. The list tells you beforehand: “Meals will be swapped”. Days when you're eating out and meals you've already eaten aren't offered. The shopping list doesn't change. With “Undo” you take it back.
- “Swap with another day” (for a meal over several days): The meal swaps all its days with another planned meal. To do this, you choose the second meal from a list. The days stay the same, only the meals change places. The shopping list doesn't change. With “Undo” you take the swap back. If you've already eaten some of it today, it can no longer be swapped.
- Under “Servings for this day” you can cook for more or fewer people once; for a meal over several days, the number per day applies to all of those days. The row then shows “for 4”.
- “Choose another meal”: replaces the meal with one from your list. The ingredients of the new meal go onto the shopping list. Those of the old one disappear from it. Afterwards you can take the change back with “Undo”.
- “Clear day” takes the meal out of the plan and its ingredients off the shopping list. With a meal over several days, you choose between “Clear this day only” and “Clear all days”. This too can be undone straight afterwards.
Not everything disappears from the shopping list. What you've already ticked off or changed by hand stays. If you've already eaten some of the meal, the shopping list stays unchanged. If an entry you changed by hand stays, the app tells you.
Eating out or getting a takeaway
Not cooking one day? Then tap the three dots at the top right of the plan and then “Add eating out / takeaway”. After that you choose the day. This isn't a meal, it's a note. The day then counts as taken. In the stats you can later see on how many days you really cooked. With the “X” icon in the row you remove the note again.
If you add the note for today, it counts as confirmed straight away. If you added it in advance, the “Confirm” button appears in the row on the day itself. Tap it if you really did eat out. Only then does the day count for your streak (section 14). You can take both back straight afterwards with “Undo”. If you've switched the streak off, the button isn't there.
7. Marking meals as eaten and making corrections
Marking a meal as “Eaten” is the most important thing. It starts the cooldown and feeds the stats. Just planning isn't enough.
How to mark what you've eaten
- In the plan: The meal for today has the “Eaten” button. After you've pressed the button, it says “Eaten” with a tick in front of it. You can take back a slip with “Undo”. With a meal over several days, you mark each day separately. This only ever works on the day itself.
- In the evening via a reminder: If you've switched on the evening reminder (section 18), the app asks “Eaten already?”. The “Eaten” button in the notification then marks it for you.
- In the meal: Via the three dots at the top right, then “Eaten today”. If nothing is in the plan for today yet, the meal then shows there as eaten.
Correcting recent days
At the top of the plan you see the last four weeks and what you ate. To change something, tap the entry:
- “Mark as eaten” records that you ate the meal.
- “Add past meal” adds a meal for that day afterwards. No ingredients are put on the shopping list.
- “Remove entry” deletes the entry.
Changes to recent days don't change the shopping list.
In the meal
In the meal, “History” shows when you ate it. If you tap an entry, you can move it with “Change date” or remove it with “Delete entry”. With “Add entry” you add a day you forgot.
8. Meals
The list
The “Meals” area contains all your meals.
- Use the search bar to look for a particular meal.
- The icon (up/down arrow) next to it changes the sort order: “Name”, “Rating” or “least recently eaten”.
- Via the three dots next to it and “Import meals” you import meals from a file someone has sent you (section 16). As long as you don't have any meals yet, “Import meals” appears directly in the empty list.
- Below that you filter by “Category”, “Cooking time” and/or “Active”.
- If you've created collections, you can limit the list to one collection (section 9).
Deactivated meals stay in the list and carry the note “Deactivated by you”.
Adding
Tap the plus sign at the bottom right, then “New meal”. The name of the meal is enough. Everything else is optional and can be added at any time: category, cooking time, photo, rating, instructions, note, ingredients and collections. Then tap “Save”. If you go back before that with something filled in, the app asks whether to discard it (“Discard” or “Keep editing”).
If the recipe is on the internet, you can bring it in with “Import from link” (section 10). You find it behind the plus sign and in the form.
Many websites also have a share function. If you use it and then pick the app from the menu, you can bring the meal into Foodplanner just as easily (section 10).
Meal packs
Meal packs are ready-made sets of six to ten meals, such as quick meals for weekdays. You find them via the plus sign and “Choose from a meal pack”. While you have fewer than five meals, a card also points you to them (“Browse meal packs”); “Don't show again” hides it.
Tap a pack to see its meals with category, cooking time and ingredients. The arrow shows the ingredients and instructions. Tick the meals you'd like and tap “Add … meals”. Meals you already have are listed under “Already in your meals” and aren't added twice.
The added meals go into a collection named after the pack, without a rating and with amounts for two servings. “Go to collection” shows them in the list of meals. In the free version, the preview shows how many of the 20 spots are left (section 19).
Ingredients
Type the name and confirm. The ingredient is added. The keyboard stays open. That way you enter one ingredient after another. You can add an amount with a unit, but you don't have to.
Pantry items such as salt, oil, rice or pasta are usually at home anyway. You mark them with the icon (box) next to the ingredient. The mark applies to the ingredient in all meals, and so does removing it. On the shopping list they are then listed only once. Under “Check pantry” you just confirm briefly whether you still have them (section 11).
To rename an ingredient, tap its name. Entries on the shopping list keep the old name.
Servings
Below the ingredients you'll find “Recipe makes”: how many servings the meal's amounts are for. Foodplanner scales the amounts to the number you chose in Settings under “I usually cook for” and shows underneath how many servings it's scaled to, for example “Scaled to 2 servings (recipe: 4)”. If you chose a different number for a day in the plan and open the meal from there, that day's number applies. The recipe's amounts are always what's saved; tapping an amount changes the recipe's amount.
Without a number in “Recipe makes”, nothing is scaled. For baking and anything that only works as a whole, there's “Don't scale amounts”. Very small amounts (less than a quarter of a piece or spoon) show as “a little”; a pinch stays a pinch.
Instructions
Below the ingredients are the instructions: a field for the steps, one step per line. When you import a recipe, the app fills it with the steps from the web page (section 10). Like the other fields, it saves as soon as you leave it.
With the arrow next to the heading you collapse the instructions and expand them again. Collapsed, only the first step shows. The instructions are also available in the free version.
Editing
To edit a meal, tap it. Changes are saved automatically as soon as you leave a field. With “Done” (top right) you get back to the list of meals.
The three dots at the top right:
- “Duplicate” creates a copy of the meal.
- “Share meal” sends the meal to someone else (section 16).
- “Eaten today” marks the meal as eaten for today.
- “Add ingredients to shopping list” puts the ingredients on the shopping list without planning the meal.
- “Undo skip” only appears if you've skipped the meal.
- “Deactivate” takes the meal out of the random pick without deleting it. “Reactivate” brings it back.
- “Delete” removes the meal along with its photo. This can't be undone. Its history entries are kept and still count towards your streak. Deactivating is usually enough.
Ingredients you added with “Add ingredients to shopping list” stay there. Even if the meal later drops out of the plan. If you delete a meal, the ingredients of its planned days disappear from the shopping list.
Several at once
Press and hold a meal in the list, then tap more meals. At the top you can reactivate, deactivate or delete the whole selection. Behind the three dots you'll also find “Select all”, “Share”, “Add to collection” and “Remove from collection”. “End selection” leaves the selection.
9. Collections
Collections let you organise meals by your own themes, such as “Gran's recipes” or “Pasta dishes”. A meal can be in several collections. Categories and suggestions aren't affected.
- Creating and managing: In the settings under “Manage collections” or in the list of meals via “Manage”. There you create a collection with “New collection”, rename it or delete it. When you delete a collection, the meals are kept.
- Assigning: In the meal, tap the right collection under “Collections”. For several meals, use the selection and “Add to collection”.
- Filtering: If you tap a collection at the top of the list of meals, you only see the meals stored in it. “All” shows you all meals again.
10. Bringing in a recipe from the internet
You don't have to type out a recipe from the internet. You can simply import it into Foodplanner.
- From the browser: Press “Share” on the recipe page, then choose Foodplanner. The link is then already in the field. Tap “Load recipe”.
- In the app: Behind the plus sign in the list of meals, or when adding a meal, tap “Import from link”. Then paste the link to the web page and tap “Load recipe”.
Foodplanner picks up the name, ingredients, instructions, cooking time and a photo. If the recipe is marked as vegan or vegetarian, the app also preselects the category. You see everything beforehand and can change it if you like. If you don't want the photo, tap “Don't use photo”. Likewise, there's “Don't use instructions” for the steps. With “Save meal” it's added.
If the page says how many servings the recipe makes, the number is already filled in under “Recipe makes”.
For this, the app only loads that one web page and its photo. And only when you tap it. Your meals and data stay on your device.
Not every web page contains readable recipe data, and some don't allow automatic import. The app tells you if that's the case. With “Add by hand” you add the meal yourself.
The app doesn't load insecure links (without https) or addresses of devices in your home. It then says “The page can't be reached.”
11. Shopping list
Entries are created in two ways. You type them in at the top under “What's missing?” and confirm. Or they arrive automatically when you plan a meal (that has ingredients). By hand you can enter anything at all, for example deodorant, shower gel, bin bags or whatever else you need.
- Source: An icon at the right edge shows where an entry comes from. Tapping it opens “Needed for”: which meals and how much, with “no amount” where none is given. This also applies to entries from fridge mode (section 12) and to pantry items.
- Amounts are added up across several meals, even across units: 500 g and 1 kg make 1.5 kg. From 1000 g or 1000 ml, the amount is shown in kg or l if it comes out evenly: 1500 g as 1.5 kg, while 1250 g stays 1250 g. The meal shows it the same way, and what you entered is kept as it is. If one meal says “200 g peppers” and another just “peppers”, there is one row with 200 g; the icon at the edge shows that another meal needs peppers with no amount. If the units don't go together, such as 200 g and 2 pieces, there are two rows. The app doesn't guess how much is meant. Singular and plural count as the same ingredient: “onion” and “onions” become one row, and the name that was on the list first stays. Ingredients from fridge mode are counted too, because they bring their amount with them.
- Ticking off: What's done slides down below the “Completed” row. “Clear completed” deletes all completed entries from the shopping list.
- Changing: Press and hold an entry to change its name, amount or quantity. You can also delete it there (“Delete entry”). A short tap ticks the entry off.
- Servings: Ingredients are added in the scaled amount. If the number of servings changes later, open items follow. If you've already ticked an item off and more is needed now, the rest is added as a new item; the ticked one stays as it is. Hand-edited items stay as they are too. Pieces are rounded up to whole pieces.
- Taken out of the plan: If you clear a day or choose another meal, its ingredients disappear from the shopping list again. What you've ticked off or changed by hand stays. Entries from fridge mode stay too.
Check pantry
Pantry items are listed separately, at the top under “Check pantry”, with everything else below under “To buy”. For each pantry item, the app asks whether you still have it. The tick makes it disappear. The trolley puts it on the shopping list. Both can be undone. If meals need a pantry item in amounts that don't go together, the row shows both, for example 500 g + 1 pack.
If you've confirmed a pantry item with the tick, it stays that way – even if the meal later drops out of the plan.
Passing it on
Via the three dots there's “Share shopping list”. This turns the shopping list into an ordinary message. The recipient doesn't need the app.
12. Fridge mode
How to get there: the fridge icon at the top right of the suggestion page.
Standing in front of the fridge with no idea what to cook? Type in what you've got. One ingredient is enough. Then all the meals that contain this ingredient appear. Right at the top is the meal you have the most for.
Under each meal you can see how much is already there, for example “3 of 8 ingredients at home” or “You've got everything”. Below that is what's missing. If a lot is missing, the app names the first three ingredients and then, for example, “and 2 more”. With “Add missing to shopping list” you put everything that's missing straight onto the shopping list. These entries stay, because they don't belong to any plan. After you've added the ingredients, the display changes to show you that they've been added. That way you can't add the ingredients to your shopping list several times by accident.
The ingredients go onto the shopping list just as they are in the meal, with amount and unit. Pantry items end up under “Check pantry” (section 11). A message appears at the bottom, for example “3 ingredients added to the shopping list”. With “Undo” you take that back. After adding, the meal shows “On the shopping list” instead of the button. If something new is missing later, the button is back and only puts the new item on the shopping list. The button is also back if you tick the ingredients off or delete them.
The “Assume pantry items are at home” switch is on by default. That way you don't have to type in salt, oil and the like every time. They're then not listed as missing. But a meal only appears if you've typed in at least one of its ingredients yourself.
The more ingredients you enter, the better the order fits. The spelling doesn't have to be exact: “onion” also finds “onions” and “red onion”. The app doesn't recognise parts of words. So “pea” doesn't find “peach”.
A meal with a lock is one you've only just eaten. You can still cook it. If none of your ingredients matches a meal, it says “No match yet”.
13. Stats
How to get there: the bar chart at the top right of the suggestion page.
Right at the top are your badges (section 15), then your streak: “Current streak”, “Longest streak” and your streak medals (section 14).
You can see what you've eaten most often (“Most eaten”, “Top 10 overall”), how the categories are spread over the last 90 days and what you haven't had for a while.
“Cooked per month” counts cooking days, not portions: cooking on Monday and eating it until Wednesday is one cooking day, not three. The small number below shows the days on which you ate out or had a takeaway.
14. Streak
The streak shows how many days in a row you've marked what you ate. It reminds you to keep doing it. Because the suggestions depend on these entries.
What counts
- A day counts if you mark something as eaten on the day itself. It doesn't matter how: plan, reminder or in the meal.
- Until 12:30 am, an entry still counts for the previous day.
- Days added later don't count.
- Eating out counts if you add it on the day itself or confirm it with “Confirm” (section 6).
- If a day is missing and the grace day has already been used, the streak starts again at zero. You keep your longest streak and your streak medals.
The grace day
Once a week you're allowed to miss a day. The streak then stays in place but doesn't grow that day. This happens by itself. The week runs from Monday to Sunday. You can't save up the grace day.
The flame
On the suggestion page there's a flame next to the title with the number of your days.
- Coloured background with a filled flame: you've already marked something for today.
- No colour and only an outline: today is still open.
- Grey and without a number: your streak is at zero.
- A crossed-out shield after the number: this week's grace day has been used.
Tap the flame to get to the stats. Press and hold it and it explains the streak to you. Before your first entry you won't see the flame yet.
Streak medals and congratulations
For certain streaks you get a streak medal. The streak medals are chillies. The longer your streak, the hotter the chilli. There are twelve: Bell Pepper (1 day), Pepperoncini (3 days), Poblano (7), Jalapeño (14), Serrano (30), Cayenne (50), Peri-Peri (100), Thai Chilli (200), Habanero (365), Scotch Bonnet (500), Ghost Pepper (750) and Carolina Reaper (1000 days).
When you earn a streak medal, the app shows you a short congratulations message after the entry. With “Continue” you close it. You'll find all streak medals in the stats under “Streak medals”. It also says there when you earned them. What's still missing carries the note “not yet earned”.
If you've switched off animations on your phone, nothing moves in the congratulations either.
Viewing streak medals
Tap a streak medal in the stats. Then you see it enlarged.
- If you've already earned it, it shows its name and the days, for example “Habanero – 365 days”. Below that, in large type, are the date (“Earned on 19 Jul 2026”) and the sentence from the congratulations.
- If it's still open, it's grey. Then it says how far there is to go, for example “12 more days to Habanero”. The app works this out from your current streak.
With “Close”, with Back or with a tap beside it you're back in the stats.
Sharing your streak
From seven days on, the congratulations message has the “Share” button. The app then creates a picture with your number and opens your phone's share menu. There you choose where it goes. It comes with a sentence with the name of the streak medal you've earned and your days in a row. The app itself doesn't send anything. The picture is only created on your phone.
You can also share each streak medal you've earned individually. Tap it in the stats and then “Share”. The picture shows the streak medal with its name, days and date. It comes with a sentence with the name of the streak medal and the corresponding days. Here too, the app itself doesn't send anything.
Switching the streak off
In the settings there's the “Show streak” switch. If you switch it off, the flame, the streak in the stats and the congratulations for the streak medals disappear. “Confirm” for eating out is then gone too. Nothing is deleted. The streak keeps counting in the background. But eating-out days added in advance don't count during this time.
The streak belongs to your phone. It's included in the backup (section 17).
15. Badges
Badges show you everything Foodplanner can do. You get one for each feature you try for the first time, such as your first backup, your first recipe from a link or three collections. They have nothing to do with streak medals: those count days in a row, badges reward single actions.
Viewing badges
In Stats, above “Streak”, the “Badges” section shows the ones you earned most recently. “All badges” shows the whole list. Badges you've earned show their picture, name and date; tap one and “How you earned it:” tells you what you did to get it. Badges you haven't earned yet look pale, with what you need to do underneath, some with progress such as 4 of 10. Tap a badge you haven't earned and “Try it” takes you straight to the feature.
A badge you've earned stays, even if you later delete a photo, for example. The badge for a custom theme needs the full version.
New badges
Your first badge comes with a little celebration that also shows how you earned it. After that the app shows a short line at the bottom, several at once together. If a streak medal is due at the same time, it comes first.
Turning badges off
In Settings, under “Badges”, turn off “Show badges”. The section and messages disappear. Anything you earn in the meantime appears quietly in the list when you turn them back on.
16. Sharing
One meal
In the meal via the three dots, then “Share meal”.
Several meals
In the list of meals, press and hold a meal, tap more meals, then “Share” via the three dots.
What goes along
Included are the name, category, cooking time, ingredients, instructions, note, photo and the names of the collections. Rating, history and plan stay with you. Whether you've deactivated or skipped a meal isn't passed on either.
The file is named after the meal, or something like Foodplanner-3-meals for several meals. It comes with a short note on how to open it and a link to Foodplanner on Google Play.
At the recipient's end
The recipient has to tap the file. If Android asks what to open it with, they choose Foodplanner. The app then opens the list of meals, and under “Import meals” they see what's new. With “Import” the new meals end up in their Foodplanner, active and without a rating. Meals they already have are skipped and stay as they are. Their own meals and their history stay unchanged.
In the overview you choose which of the new meals to import. Without the full version, the app only adds as many as still fit under 20 (section 19).
Instead of tapping the file, you can also choose it in the list of meals via the three dots and “Import meals”. If the file is a backup, the app asks first: “Import meals only” takes just the meals, “Restore …” leads to restoring in the settings (section 17).
The app rejects a damaged file or a file that doesn't come from Foodplanner. It then tells you that it can't read the file.
17. Backing up and changing devices
Everything is stored only on your phone. If it gets lost, the data is gone too unless you have a backup. So back up your data now and then. Once a month is enough, unless you add new meals regularly.
Backing up
In the settings under “Backup”:
- “Back up” writes everything to a file that you save yourself: meals, ingredients, photos, collections, history, plan, eating-out notes, shopping list, fridge and your streak. The file ends in .foodplanner.
- “Share backup” sends the same file on directly, for instance to yourself by email.
Settings such as theme, light and dark or reminders are not in the backup.
The updated app can still read older backups.
Restoring
“Restore” brings your data back. To do this, you choose the backup file. You can also tap the file directly in your file browser. After that, the app asks how it should proceed:
- “Merge” adds what's new and keeps the newer version of what you already have.
- “Replace” deletes everything you have first.
- “Import meals only” takes just the meals, without history, plan, fridge and shopping list, for example if someone gave you their backup.
Without the full version, “Replace” always brings everything back. “Merge” and “Import meals only” only add new meals as long as they fit under 20; the app tells you beforehand how many that is (section 19).
Before every “Replace”, the app keeps your previous data, only on your phone and only the latest. If the result isn't what you expected, go to “Backup” in the settings and use “Restore data from before replacing”. The option is only there while that data exists; it disappears after restoring. If there isn't enough free storage for this, the app doesn't replace anything and tells you so.
It's better to read in shared meals via “Import meals” in the list of meals (section 16).
If a photo in the file is damaged, the app still reads in everything else. It then tells you that not all photos were added. The app rejects a file that is damaged or doesn't come from Foodplanner. Entries from an older backup don't count for the streak.
New phone
If you transfer the apps from your old device when setting up a new Android phone, Foodplanner's data comes along directly on Android 9 and later. This runs between your two devices. There's no backup in the cloud. Even so, it's safer to create a backup beforehand and read it in on the new phone.
If you've bought the full version, the purchase belongs to your Google account, not to the backup. With the same Google account, the app recognises the purchase on the new phone by itself. If it doesn't, “Restore purchase” in the settings helps.
18. Settings and reminders
How to get there: in the plan, the three dots at the top right, then “Settings”.
- Appearance: “System”, “Light” or “Dark”, plus the themes (section 19).
- Reminders: see below.
- Streak: “Show streak” (section 14).
- Badges: “Show badges” (section 15).
- Meals: “I usually cook for”: how many people recipes and the shopping list are scaled for; with “Don't scale” everything stays as in the recipe. Also “Manage collections”.
- Widgets: one button for each widget that puts it on your home screen (see below).
- Backup: “Back up”, “Share backup”, “Restore” (section 17).
- Full version: whether you've bought it, “Buy full version” and “Restore purchase” (section 19).
- Language: “System default”, “English” or “Deutsch”. This area exists on Android 13 and later; on older devices Foodplanner follows the language of the phone.
- Help: “Guide” opens this guide with search and table of contents. In the plan, the list of meals and the shopping list you'll also find “Guide” behind the three dots, where it opens straight at the matching part. Back takes you from there to the table of contents. “Show quick tour” starts the tour again. “Rate the app” opens the app's page on Google Play, where you can rate it. There are also “Legal notice”, “Privacy policy” and “Licences”, all readable without the internet.
Reminders
Both reminders are off to begin with. You choose the time yourself.
- “Morning reminder” gets in touch if nothing is planned for today yet. The default is 9 am.
- “Evening reminder” asks whether you've eaten the planned meal. The default is 7 pm. The “Eaten” button in the notification marks the meal as eaten directly.
If “Eating out / takeaway” is in the plan for today and hasn't been confirmed yet, the evening reminder asks “Did you eat out today?” instead. With “Confirm” it's done. If you've switched the streak off, this question doesn't come.
When you switch a reminder on, Android asks you whether Foodplanner may show notifications. Without this permission there are no reminders.
Widgets
Two widgets bring Foodplanner to your home screen. You add them in the settings under “Widgets” or like any other widget: touch and hold an empty spot on your home screen and pick the widget from the list.
- Today shows today's meal with its category and your streak, and tomorrow's meal if there's room. With “Eaten” you mark it as eaten straight away. If “Eating out / takeaway” is in the plan, you confirm the day there with “Confirm”. Tapping the widget opens the plan, or the suggestion if nothing is planned. If you make the widget wider, it also shows the cooking time and, if the meal has one, the photo. Shrunk to a single row, it shows just the name and “Eaten”, with a small photo or the category symbol beside them and, if there's room, your streak. At its narrowest, “Eaten” becomes a round tick. It can't be made taller than two rows.
- Shopping list shows the open entries. Tapping an entry ticks it off, “+” opens the shopping list so you can type. Bringing an entry back only works in the app. This widget is part of the full version. Without it you can still add the widget, but it only shows a lock, and a tap takes you to the full version in the settings.
After a few days of “Eaten”, the plan points out the widget once with a card. “Add widget” adds it, “Don't show again” hides the card for good.
19. Themes and full version
Themes
In the settings under “Appearance” you choose a theme. It only changes the colours. “Standard” is free. The other themes are part of the full version. Among them is “Dynamic”, which takes the colours of your wallpaper (Android 12 and later only). There are also two custom themes whose colours you can set yourself.
You can still tap a theme with a lock. The app then shows it only as a preview. With “Back to Standard” you end the preview. With “Unlock full version” you buy the full version.
You set up a custom theme in the “Custom theme” editor: name and main colour, and all three colours if you like. “View in the app” shows it as a preview. “Save” only works if you've bought the full version.
Full version
Foodplanner is free and has no advertising. The free version can do almost everything in this guide. There are only three exceptions: you can add 20 meals at most, only use the “Standard” theme and not use the “Shopping list” widget (section 18). Deactivated meals count, deleted ones don't.
From the 15th meal, the list of meals shows how many meals you already have, for example “18 of 20”. Once all 20 are used, it says “20 of 20 meals · Full version for more”. Tapping it opens a panel with “Buy full version” and “Maybe later”. The same panel appears as soon as you want to add a new meal at the limit: when you tap “New meal” or “Import from link”, when you duplicate a meal and right at the start of a recipe import, not only when you save. With “Maybe later” everything stays as it is, including anything you've already typed. If you buy the full version, you carry straight on.
The full version is a one-off purchase via Google Play, with no subscription and no advertising. With the full version you can add as many meals as you like, use all the themes and tick off your shopping list on the home screen.
In the settings under “Full version” you can see whether you've bought it, and you can buy it there. If the app is locked after a reinstall even though you've bought it, tap “Restore purchase”. Redeemed a code in the Play Store? Just open the settings. The app then checks by itself whether you have the full version. If a payment takes longer, it says “Purchase pending” there until Google Play confirms it. Without the internet, the last known state applies, in flight mode too.
More than 20 meals, from a backup for example, are kept even without the full version. You can view, edit, roll and plan them, you just can't add new ones. “Replace” and the transfer to a new phone always bring everything back. “Import meals”, “Merge”, “Import meals only”, the meal packs and the example meals only add as many as still fit under 20 without the full version. The app tells you beforehand how many that is. When importing and with meal packs, you choose which ones yourself.
If a purchase is refunded, the free version applies again. All your meals are kept. A full-version theme stays saved, but “Standard” is shown.
20. Quick help
I tapped “Eaten” by mistake. Straight afterwards, “Undo” helps. Later you can do it in the plan: tap the entry in the recent days and choose “Remove entry”. Or in the meal under “History”, delete the entry or change its date.
One meal keeps coming up, another never does. It's a weighted random pick, not a fixed order. Over a longer time it evens out. Is one getting on your nerves? Then use “Skip today” or give it a lower rating.
The app doesn't suggest anything. Usually a filter is too narrow or all matching meals are on cooldown at the moment. The app then shows the reason and a button to lift the filter.
The app suggests something I've only just eaten. Then it probably wasn't marked as eaten. Without that, the app doesn't know what you had (section 7).
I can't find the settings. In the plan, the three dots at the top right, then “Settings”.
The reminder comes too late or not at all. Some manufacturers delay reminders in power-saving mode. It often helps to exclude Foodplanner from battery optimisation. The first time you switch on a reminder, the app points this out and offers “Open battery settings”.
A shared file doesn't arrive or can't be opened. Save the file and open it from there. Or send it by email instead of by messenger. In the app you can also do it via the list of meals, the three dots and “Import meals”.
My streak has dropped to zero. Then a day is missing, and this week's grace day had already been used. Adding it later doesn't help, because only what you mark on the day itself counts (section 14).
21. Feedback
If you notice anything, write to us: support@foodplanner-app.de
Whether it's unclear, unexpected or annoying in everyday use: every hint helps us make Foodplanner better.
Back to top