> For the complete documentation index, see [llms.txt](https://docs.foodcore.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.foodcore.io/meal-planning-core/meal-planning.md).

# Meal planning overview

{% hint style="info" %}
📦 Available on **FoodCore Core**. [Upgrade your plan](https://docs.foodcore.io/getting-started/essentials-vs-core.md) to access this feature.
{% endhint %}

Meal planning in FoodCore lets you map out a full week of meals across breakfast, lunch, dinner, and snack slots — with live nutrition and cost figures for every dish. It's designed for caterers, care settings, schools, and anyone who needs to plan balanced, budget-conscious menus across multiple days or sites.

## What meal planning is for

The Meal Planner is most useful when you need to:

* **Plan nutrition across a week** — see estimated kilocalories per serving for every dish, and spot days where a menu is light or heavy
* **Manage food costs against a budget** — the estimated cost per serving appears alongside each planned dish, so you can see the cost implications of your menu choices before you cook anything
* **Create a structured weekly menu** for a care home, school kitchen, or canteen — with a format that can be printed and shared
* **Coordinate multiple sites** — if you operate more than one kitchen, you can create separate plans per site

Every recipe you drag into the planner brings its nutritional estimates and costing data with it, calculated automatically from the recipe's ingredients.

## See it in action

{% embed url="<https://youtu.be/LTufRv2SeVw>" %}

![Meal planning screenshot](https://2634348187-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG8od1eHZMN9iqk1QqWM2%2Fuploads%2Fgit-blob-85113a32e1eebe41614471ec4a68a2b6d3b1441a%2Fmeal-planning.png?alt=media)

## Create a meal plan

1. **Go to Meal Planning** in the main menu.
2. **Tap + New Plan**.
3. **Enter a name** — for example, "Week of 16 June" or "Care Home Menu — July".
4. **Set the start and end dates** for the plan period (typically a week).
5. If you operate **multiple sites**, select the relevant site from the dropdown. Each site can have its own plan.
6. **Tap Create** to open the weekly planner view.

## Add meals to the plan

The weekly planner shows a grid of days (columns) and meal periods (rows): Breakfast, Lunch, Dinner, and Snack.

**On desktop:** Drag a recipe from the recipe panel on the left into the relevant day and meal period slot.

**On mobile:** Tap a slot to open the recipe picker, search for the recipe, and tap to add it.

Each slot shows:

* **The recipe name**
* **Estimated kcal per serving** — calculated from the recipe's ingredients and their nutritional data
* **Estimated cost per serving** — calculated from the recipe's ingredient costs

If a nutritional value or cost figure is missing, it's because the underlying recipe or ingredient data is incomplete. You can update ingredient nutritional information in the Ingredients section.

## Remove a meal entry

To remove a dish from a slot, **tap the × button** on the entry. The slot returns to empty and the weekly totals update immediately.

## Navigate between weeks

Use the **forward and back arrows** above the planner grid to move between weeks within the plan's date range. The plan saves automatically as you make changes.

## Print or export the plan

Once you're happy with the week's menu, **tap Print** (or Export) to generate a formatted version of the plan. The printed plan shows the full week's menu with meal periods clearly labelled — suitable for posting in a kitchen, sharing with staff, or including in care records.

## Make the most of the planner

A few things that make meal planning more effective in FoodCore:

**Keep your recipes up to date.** The kcal and cost figures are only as good as the data behind them. If ingredient prices have changed or you've updated a recipe, those changes flow through automatically to the planner.

**Use published recipes.** Only published recipes appear in the recipe picker when building a plan. Recipes in draft are excluded, so publish your tested recipes before planning with them.

**Plan nutrition deliberately.** If you're catering for a care setting or school with specific dietary requirements, check the kcal figures per day to make sure the plan meets the needs of the people you're cooking for. The planner gives you a quick overview — detailed nutritional breakdowns are available on individual recipe pages.

## What's next

* [Recipes](https://docs.foodcore.io/recipes/recipes.md)
* [Business insights](https://github.com/CharliesGFTreats/foodcore-docs/blob/master/analytics/README.md)
