Documentation
Ingredients
Manage the ingredients used across your menu items.
Ingredients
Ingredients are the building blocks of your menu items — the individual components customers can add, remove, or swap at checkout.

Ingredient details
- Name and Description
- Thumbnail — an image representing the ingredient
- Ingredient Type — an optional category for the ingredient
- Price — added to an item's total when this ingredient is included as an add-on
- Nutrition facts — Calories, Fat, Saturated Fat, Trans Fat, Cholesterol, Carbs, Sodium, Protein, Sugar, and Fiber
Managing ingredients
Edit or delete an ingredient directly from its card. Deleting an ingredient archives it instead of removing it permanently — see the Archived tab.
Importing from a file
The Import from File action (in the speed-dial button in the bottom-right corner) bulk-creates ingredients from a single .zip file — handy for loading a starter catalog or demo data without entering each ingredient by hand.
The zip must contain:
- A JSON file named
ingredients.json, holding an array of ingredient objects - An
images/folder alongside it, holding the image referenced by each ingredient'simage_path
Each ingredient object in ingredients.json looks like this:
{
"name": "Beef patty",
"description": "1 cooked patty",
"nutrition": {
"calories": 290,
"fat_g": 20,
"saturated_fat_g": 8,
"trans_fat_g": 0.8,
"cholesterol_mg": 100,
"sodium_mg": 85,
"carbs_g": 0,
"protein_g": 27,
"sugar_g": 0,
"fiber_g": 0
},
"extra_price_usd": 3.0,
"image_path": "images/beef-patty.png",
"dietary_type": "meat"
}
image_pathis relative to whereveringredients.jsonitself sits inside the zip — whether you zip a folder's contents directly or zip the whole folder, the image resolves correctly either way, as long asimages/is a sibling ofingredients.json.dietary_typeis optional — usenull, or omit it, for an ingredient with no dietary tag. Valid values match the Ingredient Type dropdown:gluten,dairy,nuts,eggs,soy,meat.- If an ingredient's
namematches one that already exists, that ingredient is skipped (not updated) — so the same file can be re-imported safely without creating duplicates. - A summary toast reports how many ingredients were created, skipped, and (if any) failed as the import runs.
- If the zip doesn't contain an
ingredients.json, you'll get a toast error instead — if it recognizes an Item, Menu, or Variety archive in there instead, it'll suggest that as the correct import type.