Every field, badge, and state on the recipes list and a recipe's detail — recipe types, statuses, versions and approvals, allergens, and documents, and where each value comes from.
On this page
Was this helpful?
Real help from real food people
Chef Diego runs a real food plant. If this page didn't get you there, tell us — a person reads every message.
You pull up your marinara to settle a question from the floor: is the kitchen
weighing to the version your quality lead signed off, or an older one? The answer
is in the badges — the recipe's status, its latest version, whether that version
is the one runs are allowed to pull. A
carries a lot of state, and this page is the key to all of it, so you
can read one at a glance and know exactly what it will do on a run. Open
Recipes under
Production to read along. Kitchen+
The recipes list
The list holds every recipe in the company you're working in, one per row. The
controls above it:
Search by name or WIP number — filters the list as you type, matching the
recipe name and its
.
Filter by type — All types, Final recipes, or Sub-recipes.
Filter by status — All statuses, Draft, Active, or
Inactive.
Filter by department — narrows to the department that owns the recipe,
drawn from your own departments.
Sort — Sort by WIP number or Sort by name, with a direction toggle
for ascending or descending.
Clear filters — appears once any search, filter, or non-default sort is
active, and returns the list to its default.
New sits in the top corner and opens the recipe form; it shows only if your
role can create recipes. When the list is empty, it reads No recipes yet.
What each row shows
Reading a row left to right, then down:
WIP number and name on the first line, followed by two badges: the
recipe type and the recipe status.
A second line of detail: the department that makes it, the batch yield
(a weight in pounds or a count of units, per batch), the output product for
a final recipe, and — when the recipe has been cut into a version — the
latest version number with its approval status. A recipe with no
version yet shows a dash in that spot.
Recipe types
Every recipe is one of two types, shown as the first badge on its row and in its
header:
Final recipe — something you sell. A final recipe names an output
product: the finished good a batch becomes.
Sub-recipe — a
. A sub-recipe has no output product; it carries a shelf life
instead, and it can be picked as an ingredient inside other recipes.
Recipe status
The status badge is the recipe's own lifecycle, separate from any version's
approval state:
Draft — newly created and not yet cleared to run. A draft is the master,
but a run won't pull it until one of its versions is approved.
Active — has an approved version and is ready for the floor. Approving the
first version of a draft flips the recipe to Active on its own.
Inactive — deactivated. It drops out of production and stops feeding runs,
and its whole history stays intact.
A recipe's detail
Selecting a recipe opens its detail page. Its header carries the same two badges
the list does — the recipe's type and status — above a strip of tiles that gives
the summary; the sections below hold everything a batch is built from.
Summary tiles
Batch size — one batch's weight, in pounds.
Recipe yield — how much a batch makes, in the recipe's
.
Shelf life — the days a batch keeps, or a dash when it isn't set.
Department, Company, and — for a final recipe — Output product.
Ingredients and allergens
The Ingredients section lists each line with a badge marking it a Product
or a Sub-recipe, its quantity in the entered unit and in pounds, and — where
some is lost in the make — a badge for the extra it adds to cover that loss.
Alongside the heading, a running total cost and cost per pound or unit
show what a batch costs. When a line is a sub-recipe, its own ingredients roll up
under Compiled sub-ingredients.
The Allergens section is derived, not entered: Bettr reads the allergens off
every ingredient product and sub-recipe and lists each one with the ingredient it
came from, so a recipe's allergen profile always matches what's actually in it.
Where allergens are set on a product is covered in the
Products reference.
A recipe's allergens are read off its ingredients, not typed in — each one listed with the ingredient it came from.
Production steps
Production steps are the method, numbered in order. Each step shows its
instruction and, where they apply, the equipment it runs on, whether it needs
a weight capture, its batch weight range and temperature range, and an
expected duration. A step can also carry
, shown as thumbnails on the step.
Run configuration
Run configuration holds the rules a run enforces for this recipe:
Cooking log and Cooling log — whether the floor records
temperatures, and the
minimum cooking temperature when the cooking log is on.
Authority — the food-safety authority the logs answer to, FDA or
USDA.
Input format — Weigh every batch or Weigh once per run, with the
weighing tolerance for per-batch weighing.
Require output before next batch — whether a batch must record its output
before the next one can start.
Packaging groups — the count groups the floor can record output in, each
with its units per group.
Documents and links
A recipe holds up to four Documents, one per type: SOP document,
Quality forms, Safety procedures, and Final product photos. Each
shows its filename and opens the file. Links are external URLs — an SOP or a
spec sheet — each with an In production badge when it's set to show on the
floor. Attaching documents and step media is covered in
Attach recipe documents and step media.
Versions and approval
Editing a recipe never changes what the floor is making. Every save is kept as a
, and to send a recipe
up for sign-off you freeze a revision as a numbered version. The Versions
panel, at the bottom of the Last version tab, lists every revision newest
first and marks which ones have been frozen.
Version status
The badge on a version tells you where its approvals stand:
Pending — frozen and numbered, waiting on its approver roles. Each required
role decides on its own row — Pending, Approved, or Rejected — and
the version stays Pending until every role has approved.
Approved — every required role signed off, and this is the recipe's current
approved version.
Superseded — was approved once, but a newer approved version has taken its
place.
Rejected — a required role turned it down. A rejection is final; to keep
going you cut a new version.
Only the latest version can be decided
Approvals happen on the newest version, so a change you're still working out
never blocks the version the floor is on. The Approved version tab always
shows the version a run pulls, even while a later one waits for sign-off.
The version tabs
A recipe's detail opens on one of three tabs:
Approved version — the frozen, approved recipe a run pulls: its ingredients
and steps as signed off.
Last version — the working recipe, including edits made since the last
approval, plus the Versions panel.
R&D recipes — the branches taken off this recipe (hidden on a branch
itself).
The production version and R&D branches
By default a run pulls the main recipe's approved version. You can point it at a
branch instead: a
is set with Set as production and marked with a Production
version badge in the header. Clear production version hands the floor back
to the main recipe.
An R&D recipe is a branch you develop without touching what's running:
Copy to main recipe writes a branch's ingredients and steps back over the
main recipe as a new revision. The full flow is covered in
Version and approve a recipe.
Who can view and change recipes
Access to recipes is set per role, under Production in the permission
catalog:
View recipes — open the list and read any recipe. Without it, the page
redirects to an unauthorized notice.
Create recipes — shows New and lets you build a recipe.
Edit recipes — lets you change a recipe, cut and manage versions, set the
production version, and manage documents. Without it, the recipe opens
read-only.
Approving a version takes more than a permission. A signer needs Edit recipes
and must also hold one of the approver roles chosen on the recipe, so who owns
quality is decided recipe by recipe.
There is no delete
A recipe can't be deleted — every plan, run, and batch record points back to
the recipe it was made from, and erasing it would break that trail. Deactivate
it instead: its status becomes Inactive, it drops out of production, and its
history stays whole.