Skip to main content

Recipes

Recipes connect kitchen operations with inventory control. Use recipes to standardize dishes, calculate ingredient needs, reuse prep recipes, calculate cost per portion, and deduct stock when POS sales are processed.

Build recipe structures

Add ingredients and sub-recipes to define how a dish or preparation is made.

Calculate usage

Calculate ingredient needs, trim, cost per portion, and producible portions.

Connect POS sales

Map POS items to recipes so sales can deduct ingredient stock automatically.

Creating a recipe

Go to ManageRecipes and click Add new recipe. A recipe can contain ingredients, sub-recipes, quantities, trim percentages, and storage rules.
1

Create missing ingredients

Make sure all required ingredients exist in the ingredient master list.
2

Open Recipes

Go to ManageRecipes.
3

Create a new recipe

Click Add new recipe.
4

Enter recipe details

Add the recipe name and optionally set a default issue storage.
5

Add recipe lines

Add ingredient lines and sub-recipe lines.
6

Save the recipe

Click Create to save the recipe.

Recipe structure

A recipe can contain:
FieldDescription
NameThe recipe name — required
Default issue storageOptional fallback storage for the whole recipe
Ingredient linesIngredients from your ingredient master list
Sub-recipe linesOther recipes used inside this recipe

Recipe lines

Each recipe line is added one at a time using the Add line section at the bottom of the form sheet. Use the Line type toggle to choose between:
Line typeMeaning
IngredientA direct ingredient used in the recipe
RecipeAnother recipe used as a sub-recipe
A line contains either an ingredient or a sub-recipe — not both.

Adding ingredient lines

When adding an ingredient line:
  1. Select the Ingredient from your ingredient master list
  2. Enter the Qty per portion — the quantity needed for one portion
  3. Enter the Trim % — preparation loss percentage, optional and defaults to 0
  4. Select an Issue storage — optional, defaults to the recipe’s default storage
  5. Click Add line
The quantity per portion is required and must be greater than 0.

Example ingredient lines

IngredientQty per portionTrim
Tomatoes0.200 kg0%
Mozzarella0.125 kg0%
Beef fillet0.250 kg10%
Basil0.005 kg0%

Trim percentage

Trim is used when more stock is needed than the usable quantity in the recipe. Examples:
  • Peeling vegetables
  • Trimming meat
  • Cleaning fish
  • Removing stems
  • Cooking or preparation loss
Mathership stores trim as a decimal internally. If you enter a whole number like 10, it is treated as 10%. Formula used for ingredient needs: Required quantity = quantity per portion / (1 - trim percentage)
Qty per portionTrimActual deducted quantity
1.00 kg10%1.11 kg
1.00 kg20%1.25 kg
0.50 kg10%0.56 kg

Trim entry reference

Entered valueMeaning
1010%
0.1010%
2020%
0.2020%

Sub-recipes

Recipes can include other recipes. Use sub-recipes for preparations that are reused in several dishes. When adding a sub-recipe line:
  1. Select Line typeRecipe
  2. Select the recipe from your recipe list
  3. Enter the Portions — how many portions of the sub-recipe are used
  4. Click Add line
The current recipe is excluded from the picker to prevent direct cycles.

Examples

Sub-recipeUsed in
Pizza doughPizza Margherita
Burger sauceBurger Classic
Caesar dressingCaesar Salad
Tomato sauce basePasta and pizza recipes
When a recipe uses a sub-recipe, Mathership expands the sub-recipe and calculates all ingredient needs from the lower-level recipe.

Sub-recipe portions

When adding a sub-recipe, you define how many portions of the sub-recipe are used in the parent recipe.
Main recipeSub-recipeChild portions
Burger ClassicBurger sauce1
Pizza MargheritaPizza dough1
Sharing platterDip recipe3
Mathership multiplies the sub-recipe by the number of child portions needed.

Recipe cycles

A recipe should not contain itself, directly or indirectly. Invalid example:
RecipeContains
Sauce ASauce B
Sauce BSauce A
The recipe picker excludes the current recipe when editing to prevent direct self-reference. If a cycle is detected during POS deduction, Mathership stops that expansion and creates an exception.
Avoid circular recipe structures. They can prevent recipe expansion and create POS processing exceptions.

Editing a recipe

You can update:
  • Name
  • Default issue storage
  • Ingredient lines
  • Sub-recipe lines
  • Quantities
  • Trim percentages
  • Issue storage per line
1

Open the recipe

Go to ManageRecipes and click the recipe.
2

Click Edit

Open the recipe form.
3

Update the recipe

Change the recipe details, lines, quantities, trim, or storage rules.
4

Save changes

Save the recipe and review the detail page.

Deleting a recipe

Only delete a recipe when it is no longer needed. A recipe may not be deletable if it is used as a sub-recipe in another recipe. Open the Used in recipes section on the recipe detail page to find parent recipes that contain it.
Deleting a recipe does not automatically correct past inventory movements or POS deductions.

Recipe detail page

Opening a recipe shows a full view of the recipe with live stock and costing data. The header shows the recipe name and an active or inactive badge. Click Edit to update the recipe.

Meta strip

Below the header, the meta strip shows:
  • Default issue storage — the fallback storage for deductions
  • Aggregated allergens — allergens collected from all ingredient lines across the recipe
  • Created date

Stats

Four stat cards show live data:
StatDescription
Cost / portionTotal cost per portion based on ingredient unit costs. Shows a warning if some ingredients have no cost data.
Max portionsMaximum number of portions producible from current stock. Shows the bottleneck ingredient name when this is 0.
Recipe linesTotal number of lines, with a breakdown of ingredient lines vs sub-recipe lines
UpdatedWhen the recipe was last updated

Health warnings

If any of the following are detected, a warning banner appears:
  • Recipe uses inactive ingredients
  • One or more ingredients are not mapped to a vendor product
Ingredients without product mappings cannot be received through orders.

Recipe lines table

The recipe lines table shows all ingredients and sub-recipes.
ColumnDescription
IngredientIngredient name or sub-recipe name with type icon. Warning icon if not mapped to a vendor product. Inactive badge if the ingredient is inactive.
Qty per portionAmount needed per portion in the ingredient’s base unit
TrimTrim percentage applied to this line
EffectiveActual quantity deducted after applying trim
Unit costCurrent weighted average cost per unit
Line costQty per portion × unit cost
On handCurrent stock in the selected storage scope
PortionsHow many portions can be made from current on-hand stock for this line

Storage scope selector

In the top right of the recipe lines section, choose a specific storage unit or All storages to see stock and portions data scoped to that location. This is useful when the same ingredient is spread across multiple storage units. Click any ingredient row to go to the ingredient detail page. Click any sub-recipe row to go to that recipe’s detail page.

Used in recipes

If this recipe is used as a sub-recipe in other recipes, a Used in recipes section shows those parent recipes. Click any row to open the parent recipe.

POS mappings

If this recipe is connected to POS items, a POS mappings section shows all active connections.
ColumnDescription
IntegrationThe POS integration name and type
POS item nameThe item name in the POS system
QuantityThe portion multiplier
EffectAddition, where stock is reduced, or Subtraction, where stock is added back for removal modifiers

Connecting recipes to POS items

Recipes can be mapped to POS items. This allows Mathership to deduct ingredients automatically when POS sales are processed.
POS itemRecipe
Pizza MargheritaPizza Margherita recipe
Burger ClassicBurger Classic recipe
Caesar SaladCaesar Salad recipe
When the POS item is sold, Mathership multiplies the recipe quantities by the number of portions sold. See POS Integrations for setup details.

POS deduction example

Recipe:
IngredientQty per portion
Beef patty0.180 kg
Burger bun1 piece
Burger sauce0.030 kg
If 10 burgers are sold, Mathership deducts:
IngredientDeducted quantity
Beef patty1.800 kg
Burger bun10 pieces
Burger sauce0.300 kg
If trim is used, the deducted quantity is increased automatically.

Portion multipliers

POS mappings can use a portion multiplier. This is useful when one POS item represents more or less than one recipe portion.
POS itemRecipePortion multiplier
Pizza MargheritaPizza Margherita1
Half portion pastaPasta recipe0.5
Sharing platterPlatter recipe2

Direct ingredient POS mapping

A POS item can also be mapped directly to an ingredient instead of a recipe. This is useful for simple items that do not need a full recipe.
POS itemDirect mapping
Bottle of waterWater bottle ingredient
Packaged snackSnack ingredient

Storage selection for deduction

When Mathership deducts stock from a recipe sale, it tries to find the storage location in this order:
  1. Issue storage on the recipe line
  2. Preferred issue storage on the ingredient
  3. Default issue storage on the recipe
  4. Storage unit with available stock
  5. First available storage unit as fallback
If no storage can be found, Mathership creates an exception.

Inventory movements created by recipes

When POS sales are processed, Mathership creates inventory ledger entries. Recipe deductions are posted as:
Transaction typeMeaning
ISSUEIngredient stock deducted because of sales
The value of the deduction is calculated using the weighted average cost of the ingredient.

Weighted average cost

Mathership uses receipt entries to calculate the weighted average cost of an ingredient. This cost is used when recipe deductions, waste, transfers, or stock adjustments create inventory values. If no receipt cost exists yet, the cost may be treated as zero. This is shown as a warning on the recipe detail page when ingredients are missing cost data.

Exceptions during POS processing

POS processing can create exceptions when something is missing or inconsistent.
ExceptionMeaning
Unmapped POS itemThe POS item is not connected to a recipe or ingredient
Unmapped POS codeThe uploaded POS code has no mapping
No issue storageMathership could not find a storage location
Recipe cycleA recipe includes itself directly or indirectly
Negative stockThe deduction would reduce stock below zero
Negative stock does not always stop posting. It is reported as an exception so the issue can be reviewed.

Recipe reports

Recipes can be used in inventory reporting. Inventory reports can be filtered by:
FilterPurpose
IngredientShow movements for selected ingredients
Storage unitShow movements by storage
RecipeAnalyze recipe-related usage
Date rangeLimit the reporting period
Transaction typeShow receipts, issues, waste, transfers, or adjustments
ActivityShow only items with activity
Current stock rangeFilter by current stock level

Recipe costing

The recipe detail page shows Cost per portion, calculated from the current weighted average cost of each ingredient. If some ingredients have no receipt cost yet, the missing count is shown as a hint below the cost card. Mathership can support:
  • Ingredient usage calculation
  • Stock value deduction
  • COGS reporting from ISSUE movements
  • Recipe-related inventory analysis
The more accurate your ingredients, units, and receipt prices are, the more useful your recipe costing becomes.

Best practices

Use clear names

Use clear recipe names such as Pizza - Margherita, Burger - Classic, or Prep - Tomato Sauce Base.

Create prep recipes

Create reusable prep recipes for doughs, sauces, dressings, stocks, marinades, and bases.

Keep units consistent

Use stable ingredient base units, such as kg for flour and beef, L for milk, and piece for eggs.

Use trim carefully

Use trim only when stock usage should be higher than the usable recipe quantity.

Set storage rules clearly

Use issue storage, preferred issue storage, and default issue storage to control where deductions come from.

Review POS mappings

Before using automatic deductions, check that all relevant POS items are mapped.

Watch max portions

Use the Max portions card to see whether current stock can cover upcoming service.

Review missing costs

Missing receipt costs can cause cost per portion to show as zero or incomplete.

Good recipe names

  • Pizza - Margherita
  • Burger - Classic
  • Sauce - Burger Sauce
  • Dressing - Caesar
  • Prep - Tomato Sauce Base
Avoid vague names such as Sauce, Mix, Test, or Recipe 1.
IngredientRecommended base unit
Flourkg
MilkL
Eggspiece
Beefkg
Herbskg or g

Storage rule order

  1. Set issue storage on recipe lines for ingredients that always come from a specific place
  2. Set preferred issue storage on ingredients used consistently from one storage
  3. Set default issue storage on recipes where most ingredients come from one storage

Common workflows

Create a new menu recipe

  1. Create missing ingredients in the ingredient master list
  2. Go to ManageRecipes and click Add new recipe
  3. Enter the recipe name
  4. Set a default issue storage if all ingredients come from the same place
  5. Add ingredient lines with quantities and trim percentages
  6. Add sub-recipes if needed
  7. Click Create
  8. Map the recipe to the POS item
  9. Test with a small POS sale

Create a prep recipe

  1. Go to ManageRecipes and click Add new recipe
  2. Create the prep recipe with all its ingredients
  3. Save it
  4. Open a final recipe and add the prep recipe as a sub-recipe line

Update a recipe

  1. Open the recipe
  2. Click Edit
  3. Update quantities, trim, ingredients, or sub-recipes
  4. Save the recipe
  5. Review POS mappings if the recipe changed significantly

Process POS sales

  1. Make sure POS items are mapped to recipes
  2. POS sales are synced or imported through the active integration
  3. Mathership expands recipes into ingredient needs
  4. Stock is deducted from the selected storage units
  5. Review exceptions if any are returned

Troubleshooting

Check that the ingredient exists in the ingredient master list and belongs to the correct company.
Check that the sub-recipe exists, belongs to the same company, and is active.Inactive recipes cannot be used as sub-recipes.
Check that the name is filled in and that at least one line has been added.Lines require a valid quantity greater than zero.
Check the trim percentage.
Entered trimMeaning
1010%
0.1010%
2020%
0.2020%
Check that:
  • The POS item is mapped
  • The recipe has ingredient lines
  • The recipe is active
  • A storage location can be found
  • The ingredient exists
  • There is no recipe cycle
The recipe is probably used as a sub-recipe in another recipe.Open the Used in recipes section on the recipe detail page to find which parent recipes contain it. Remove it from those recipes first.
Review the exception list.Most issues are caused by missing POS mappings, missing storage rules, or recipe cycles.
Check that ingredients have been received with a product price.Mathership calculates cost from receipt ledger entries. If ingredients have never been received, the weighted average cost will be zero.
Check the bottleneck ingredient shown in the Max portions card.That ingredient is out of stock or has insufficient quantity for even one portion. Open the ingredient detail page to review current stock and recent movements.

Summary

Recipes are the link between kitchen operations and inventory control. They help you:
  • Standardize dishes
  • Reuse prep recipes
  • Calculate ingredient needs
  • Deduct stock from POS sales
  • Improve inventory accuracy
  • Support food cost and COGS analysis
  • Monitor producible portions from current stock

Ingredients

Manage the ingredient master list used in recipes, receiving, and stock tracking.

Storage Units

Manage the storage locations used for recipe deductions and inventory movements.

Product Mapping

Connect vendor products to internal ingredients and conversion factors.

Receiving Orders

Receive vendor orders and post mapped products into inventory.

POS Integrations

Connect POS sales to recipes so ingredients can be deducted automatically.

Inventory Reports

Analyze stock, recipe usage, movement history, costs, and ingredient activity.
Last modified on June 7, 2026