Recipes (Recipe Engineering)
Create and manage recipes manually or with AI, link ingredients to inventory with conversion factors, and track cost per portion and inventory deduction.
Common Tasks
How to Create a Recipe Manually (Add Recipe, New Recipe)
Create a new recipe from scratch when you want full control over ingredients and instructions.
- Go to Restaurant → Recipes in the left sidebar
- Click the + New Recipe or Add Recipe button
- Enter the Name and Code for the recipe
- Select the Recipe Type: FINISHED_PRODUCT (final dish), SUB_RECIPE (component like sauce or dough), PREP_ITEM, or BEVERAGE
- Enter Yield Quantity and select Yield Unit (e.g. portions, kg)
- Optionally enter Prep Time, Cook Time, Instructions, Allergens, and Dietary Flags
- Set Status to DRAFT, TESTING, APPROVED, or ARCHIVED
- Click Save or Create Recipe
Result: The recipe is created. You can then add ingredients and link them to inventory products or sub-recipes.
How to Generate a Recipe with AI (AI Recipe, Create Recipe from Description)
Use AI to generate a recipe and suggested ingredients from a dish description.
- Go to Restaurant → Recipes
- Click New Recipe and choose the AI option, or use Generate with AI
- Enter a description of the dish (e.g. "Classic beef burger with lettuce, tomato, and special sauce")
- Click Generate
- Review the generated recipe, ingredients, and optional conversion suggestions for matching to inventory
- Edit any fields as needed and Save
Result: A new recipe is created with AI-suggested ingredients. You can link each ingredient to an inventory product and set conversion factors.
AI Matching
After AI generation, the system can suggest matches to your inventory products and conversion factors (e.g. 1 bottle = 200g). Review and confirm or adjust.
How to Add Ingredients and Link to Inventory (Add Ingredient, Link Product)
Add ingredients to a recipe and link them to inventory products so cost and deduction work correctly.
- Open the recipe from Restaurant → Recipes
- Go to the Ingredients section and click Add Ingredient
- Select either an Inventory Product or a Sub-Recipe
- Enter Quantity and select the Unit (recipe unit)
- Set Waste Factor and Yield Factor if applicable
- If the product's inventory unit differs from the recipe unit, enter Conversion to Recipe Unit (e.g. 1 inventory unit = X recipe units)
- Save the ingredient
Result: The ingredient is linked. If conversion was needed and is set, recipe cost and inventory deduction will use it correctly.
Note: Ingredients with MATCHED status have a linked product and optional conversion. UNMATCHED ingredients need linking; use Rematch Ingredients to run AI matching again for unmatched items.
How to View Recipe Cost (Cost Breakdown, Food Cost)
See the cost breakdown per ingredient and cost per portion for a recipe.
- Go to Restaurant → Recipes and open the recipe
- Open the Cost or Recipe Cost tab/section
- Review Ingredient Cost (quantity, unit, cost per unit, total), Cost Per Portion, and Target Food Cost %
Result: You see which ingredients need conversion configuration and whether cost is complete. Fix any ingredients marked as needing configuration so deduction and reports are accurate.
How to Deduct a Recipe from Inventory (Recipe Deduction, Portion Deduction)
When you have sold or used portions of a recipe, deduct the ingredients from inventory.
- Open the recipe from Restaurant → Recipes
- Use the Deduct or Deduct from Inventory action
- Enter the number of Portions to deduct
- Confirm the deduction
Result: Inventory is reduced for each ingredient according to the recipe and conversion factors. An adjustment record is created.
Conversion Required
All ingredients linked to inventory must have conversion configured where units differ; otherwise deduction may fail or be incorrect.
Key Concepts
- Recipe types: FINISHED_PRODUCT is the final dish; SUB_RECIPE is a component used in other recipes (e.g. sauce, dough). Use sub-recipes as ingredients in finished products.
- Conversion to recipe unit: When inventory is in one unit (e.g. bottle) and the recipe uses another (e.g. grams), set how many recipe units per inventory unit so cost and deduction are correct.
- Waste and yield factors: Adjust quantity for trim waste and yield (e.g. edible portion) so cost reflects real usage.
- Match status: MATCHED means the ingredient is linked to an inventory product; UNMATCHED means it still needs linking or rematching.
For linking recipes to menu items, see Menu Builder. For inventory stock levels, see Inventory Management.
Troubleshooting
Recipe cost shows "needs configuration"
One or more ingredients have no conversion factor where the inventory unit differs from the recipe unit. Open each ingredient and set Conversion to Recipe Unit, or use AI-suggested conversion if shown.
Deduction fails or quantities wrong
Ensure every ingredient is linked to an inventory product and has the correct conversion factor. Check that stock is sufficient for the portions you are deducting.
Sub-recipe not appearing in ingredient list
Sub-recipes are recipes with type SUB_RECIPE. Create or mark the recipe as a sub-recipe, then it can be selected as an ingredient in another recipe.