Where Recipe Box reads/writes your grocery list note. Supports Moment.js format tokens.
Ingredients heading
Ingredients
The heading Recipe Box looks for to find a recipe’s ingredient list.
Instructions heading
Instructions
The heading Recipe Box looks for to find a recipe’s cooking steps.
Notes heading
Notes
The heading Recipe Box looks for to find a recipe’s optional notes section.
Recipe Library
Setting
Default
What it does
Recipe folders
["Recipes"]
Folder(s) Recipe Box scans for recipes. Requires at least one entry; use / to search the entire vault. Deleting the last entry restores the default. Recipe Box warns if / is set with no recipe type value, since that combination treats every vault note as a recipe.
Recipe type value
(empty)
Frontmatter type value that marks a note as a recipe (e.g. recipe). When blank, folder location alone determines detection - no frontmatter required.
Enable dashboard
On
Shows the single Recipe Box dashboard ribbon icon. When off, the separate grocery list / meal plan / gallery ribbon icons are shown instead, and the Open recipe dashboard command isn’t registered. See Dashboard.
Open gallery when clicking a recipe folder
Off
Clicking a configured recipe folder’s name in the file explorer opens the Gallery View filtered to that folder, instead of expanding/collapsing it. Marked folders get a distinct underline.
Also apply to subfolders
Off
Only shown when the setting above is on. Extends the same click behavior to subfolders, filtering the gallery to the specific subfolder clicked.
Recipe View
Setting
Default
What it does
Strip duplicate title and hero image from body
On
Removes a leading # Title from the body if it matches the note title, and removes an inline image if it matches the image frontmatter property. One combined toggle.
Use first image in note when frontmatter image is empty
On
When the image frontmatter property is unset, the recipe view uses the first image found in the note body as the hero image instead.
Default recipe image
Recipe Box’s built-in placeholder image
Shown in the recipe view and gallery when a recipe has no frontmatter or body image. Accepts a vault path, wikilink, or URL - same format as the image property. Leave blank to fall back to the plain placeholder instead. Never used on public shares.
Rating property
rating
Frontmatter property storing a recipe’s 1-5 star rating.
Cross off while cooking
On
Automatically checks off ingredient list items as you tap them during cooking.
Show tags in header
On
Displays the note’s frontmatter tags above the badge row in the recipe header.
Tag prefix
On
Prefixes each displayed tag with #.
Tag format
Last segment
Show tags as only the last segment of a nested tag path (e.g. italian rather than cooking/italian). Toggle off to show the full path.
Auto-open recipe view
On
Automatically switches a matching note into the Recipe View when opened.
Desktop recipe layout
Two column
Layout style for the desktop recipe view: Two column (hero image and ingredients on the left, instructions on the right, with a draggable resizing divider) or Classic (single-column, ingredients above instructions). Mobile is unaffected.
Reset two-column split
(button)
Restores the default 50/50 column split for the two-column layout.
Recipe Timers
Setting
Default
What it does
Enable timers
On
Detects duration phrases in instructions and shows clickable timer buttons.
Auto-start timers
Off
Starts the countdown immediately when a timer button is clicked.
Default to compact timers
Off
New timers open in compact (time-only) mode.
Timer range default
Max
For ranges like “10-15 minutes”, whether the timer uses the high (Max) or low (Min) end.
Shows a “Mark as cooked” button in the recipe view’s action bar.
Ask for date when marking cooked
Off
Prompts for a date instead of using today when marking a recipe cooked.
Track last made
On
Stamps the date into lastMade when a recipe is marked cooked. Derived automatically from cook history when cook history is enabled.
Last made property
lastMade
Frontmatter property name used to record the last-made date.
Track cooked count
On
Keeps cookedCount in sync with the number of cook history entries.
Track cook history
On
Enables full cook history - adds a structured cookHistory frontmatter array and a managed ## Cook History section in the note body. Enables the Cook History tab on mobile and the Cook History modal on desktop.
Cook history heading
Cook History
Heading name for the cook history section in the note body (case-insensitive match). Content under this heading is managed by the plugin and will be overwritten on every write.
Cook history property
cookHistory
Frontmatter property name for the structured cook history array.
Prompt for notes when marking cooked
On
Shows a notes field in the mark-as-cooked dialog; the text is stored in that cook history entry.
Track photos
Off
Shows an image picker in the mark-as-cooked dialog; the selected photo is saved as a vault attachment and embedded in the cook history section.
Whether the recipe view shows nutrition/servings as per-serving or recipe totals.
Nutrition source
Per-serving
Whether the values stored in frontmatter represent a single serving or the recipe total (Recipe Box converts as needed for display).
Calories property
calories
Frontmatter property for calories.
Protein property
protein
Frontmatter property for protein (g).
Fat property
fat
Frontmatter property for fat (g).
Carbs property
carbs
Frontmatter property for carbs (g).
Meal Plan
Setting
Default
What it does
Meal type notation
Tag
How meal type (Breakfast, Dinner, etc.) is written in the meal plan note: as a #tag/slug, a [field:: value] Dataview field, or plain (text).
Meal type field name
meal
The tag or field name used for meal type (e.g. meal produces #meal/dinner in tag notation).
Meal Recommender
Setting
Default
What it does
Modes
3 built-in modes
Named sets of filters and scoring rules. Each mode produces a different ranked list. Click a mode’s pencil icon to edit it, the copy icon to duplicate it, or the trash icon to delete it (custom modes only). Set one mode as the default using the radio button. See Meal Suggestions.
The result count (5, 7, 10, or 14) is now a selector inside the suggester dialog rather than a global setting. Cooldown logic is expressed as a filter inside each mode (e.g. lastMade → “not within last 14 days”).
Export
Setting
Default
What it does
Export folder
Recipe Exports
Default vault-relative folder for Markdown recipe exports. Can be overridden per-export in the export dialog.
Default format
Markdown (plain)
Format pre-selected when the export dialog opens. Options: Markdown (plain), Markdown (importable), JSON, JSON-LD.
Include cook history by default
On
Pre-checks “Include cook history and other sections” in the export dialog.
Rows that map one or more aliases (comma-separated, e.g. tasse, tassen) to a canonical unit (e.g. cup). Added on top of the built-in units; your mappings override built-ins with the same alias. Leave the canonical unit empty to drop the word without recording a unit. A hint appears under a row whose canonical unit isn’t built in and isn’t used by any other row.
Ingredient filler words
of
Comma-separated words (e.g. of, de, di) removed right after the quantity or unit (2 cups of flour → flour). Leave empty to strip nothing.
Preserve ingredient name casing
Off
Shows ingredient names as written in the note instead of lowercasing them, which suits languages that capitalise nouns (2 Eier). Grocery list matching still ignores casing.
Vault-relative folder where imported recipes are saved.
Import template note
(empty = built-in default)
Vault-relative path to a note used as the template for imported recipes.
Recipe Box also downloads the recipe’s hero image into your vault automatically on import (best-effort, non-blocking) - there’s no settings-tab toggle for this yet. See Importing Recipes from the Web.
Sharing
Sharing a recipe has no dedicated settings section - expiry (7/30/90 days) is chosen per-share in the Share dialog, not set globally. See Sharing a Recipe.
The gallery’s folder-click settings above live under Recipe library, not a separate settings section. See Gallery View. Whether the gallery remembers its filters between sessions is likewise not a settings-tab control - it’s the Remember filters checkbox inside the gallery’s own filter panel. The Dashboard’s cooking activity chart range (2/4/8/12 weeks) is remembered automatically and has no settings-tab control - it’s changed from the chart’s own dropdown. See Dashboard.
Commands
Recipe Box registers these commands (search “Recipe Box” in the Command Palette):
Actions like syncing the grocery list from the meal plan, clearing the meal plan, and exporting the grocery list are buttons inside the Shopping Assistant and Meal Plan view toolbars rather than separate commands.