How to View and Interpret Recipe Change History

Recipe change history provides a complete audit trail of every modification made to a recipe. Users can see who changed what, when the change occurred, and exactly what was altered. This accountability and traceability is essential because recipe changes flow downstream to procurement reports, ingredient-based aversions and restrictions, allergen declarations, and nutritional calculations.

ℹ️ The Recipes module is required to access recipe change history. Users must belong to an organisation. Location users see only changes made at their own location; organisation-level users see all changes across all locations.

How to access recipe change history

  1. Open the Recipes section
  2. Select a recipe from your list
  3. Scroll through the recipe's tabs until you reach History (the final tab, appearing after Ingredients, Costs, Nutrition, Allergens, Method, Derived recipes, and Dishes)

What each entry shows

Every change entry displays the following:

  • Timestamp: The date and time the change was made. Entries are grouped by date, with the most recent changes first.
  • Who and source: The person who made the change and their role (for example, "User · Maria Santos"). If the change came from an automated source, it shows the source type instead (for example, "Data import · Monthly supplier update").
  • What changed: A descriptive badge summarising the type of change (for example, "Ingredient added", "Quantity updated", "Diet assignment changed") alongside a "Show changes" link.
  • Where: The location where the change was made, if applicable. Blank entries indicate changes made at organisation level.

Viewing the detailed comparison

To see exactly what changed in a recipe:

  1. Locate the entry for the change you want to review
  2. Click "Show changes" on that entry
  3. A comparison panel opens, displaying the before and after state of the recipe's affected fields side by side

Understanding what is tracked

Recipe history records all changes to the recipe itself, including:

  • Ingredient names, quantities, and units
  • Ingredient order within the recipe
  • Recipe diets and any alternative recipes assigned to those diets
  • Dishes linked to the recipe
  • Recipe steps (method)
  • Location exclusions (when a location user removes the recipe from their location)

⚠️ Changes to an ingredient's own properties, such as allergen classifications or nutritional values, are recorded in that ingredient's change history, not in the recipe's history. To view ingredient-specific changes, open the ingredient's detail page and navigate to its own History tab.

Filtering by location

If a user belongs to an organisation but has no location binding, they can filter the history entries to view changes from a specific location:

  1. In the History tab, locate the location filter
  2. Select the location to view only changes made at that location

Limitations

Recipe change history is view-only; there is no search or export function. Entries display in near real time, though very recent changes may take a moment to appear. The history records who made the change and what changed, but does not include a reason or note field for each entry.