Skip to content

Recipe history and versions

We keep two kinds of history for every recipe. The timeline is every change, in order, with the assistant’s changes marked. Named versions are the ones you decided to keep: “brewed as v3”, “before the hop rework”. Both live behind Version history… in the recipe’s overflow menu.

The Version history dialog, with named versions above and the change timeline below.The Version history dialog, with named versions above and the change timeline below.

The timeline lists each change with the same one-line summary the editor uses, newest first, and a badge on the ones the assistant made. We build it from the changes we already sync, so it has two limits. It only goes back fifty changes per recipe, and it needs a connection. Offline, or on a workspace that has never synced, the timeline is empty and the editor works as usual.

Any point on it has three actions. Compare shows what changed between then and now. Restore puts the recipe back to that point. Name version saves that point as a named version, so you can keep it after it drops out of the last fifty changes.

Save this version saves the recipe as it is now. A named version is a full copy of the recipe, so editing the recipe afterward can’t change any number inside it, and “brewed as v3” always shows what you brewed. Named versions are stored with your workspace, so you can see them offline and on every device.

The default name includes the date and the time, because people often save several versions of one recipe on the same day. Rename with the pencil, delete with the trash can. A recipe can have up to twenty-five named versions, since each one is a full copy, and the timeline covers the rest.

Deleting a recipe leaves its named versions in place, so a recipe you regret deleting is still restorable.

Compare on either kind of version shows the differences from the current recipe: what was added, removed or changed, with the vitals before and after. Restore this version is at the bottom of it.

Restoring is an ordinary edit. It replaces the current recipe with the old one in a single change, which means three things. Undo puts it back, it syncs to your other devices like any other edit, and it appears on the timeline as its own entry, “Revert recipe to …”. Restoring adds to the history and never removes anything from it.

It’s still the same recipe, with the same creation date, so links to it keep working. Everything else comes from the version you chose.

Something wrong on this page? Tell us.