How BatchTrack Works
From your first login to finished products, here’s how to move through the system step by step.
See it in action — start free todayNeed Answers Fast?
The Commonly Asked Questions page links every question directly to these instructions.
View FAQFirst Login Checklist
When a new account signs in, the dashboard shows empty states that guide makers to their next step. Decide whether you want to populate inventory first or write a recipe, then follow the on-screen ribbons that link back to this page.
- Inventory-first teams add ingredients, containers, consumables, and packaging so costs and conversions work out of the gate.
- Recipe-first teams can sketch formulas immediately, but they’ll still be prompted to link lines to inventory for automation.
- The same flow repeats for staging/preview environments so every teammate experiences a consistent launch.
Getting Started
- Follow the first-login checklist to choose whether you add inventory or recipes first.
- Capture your core inventory or recipe data on day one so dashboards surface real insights.
- Invite teammates and assign roles so everyone knows their next action in BatchTrack.
First Login Checklist
- Decide your starting path. Inventory-first teams populate ingredients/containers so costs and conversions work; recipe-first teams can create formulas immediately but should link every line to inventory.
- Follow the dashboard ribbons. The blank state surfaces “Add Inventory” and “Add Recipe” buttons, each linking back to these instructions.
- Repeat this flow for every workspace. Keeping the experience consistent helps teammates share the same reference data.
Invite Your Team & Set Goals
- Open Organization → Teammates to invite coworkers and assign owner/manager roles.
- Decide which KPIs you want to highlight first—low stock alerts, production throughput, or order readiness.
- Use the dashboard ribbons to pin those priorities so every login reinforces the same goals.
- Review the inline help cards in inventory, recipes, and planning for quick reminders while you work.
Guide Teammates with Roles & Permissions
- Use Organization → Roles to define who can edit inventory, plan production, or finish batches.
- Owners can unlock subscription-tier features, while contributors can stay focused on the tasks they handle every day.
- Pair every new user with a role when they join so navigation only surfaces the workflows they need.
Image Placeholders
Drop screenshots for this section into /app/static/images/help/getting-started/. The final onboarding tour can render them as a slideshow.
Add getting-started-1.png under static/images/help/getting-started/getting-started-1.png
Add getting-started-2.png under static/images/help/getting-started/getting-started-2.png
Inventory & Global Items
- Use the global drawer when adding inventory to keep identity data clean—global items are curated, org items stay editable.
- From the inventory list you can quick-adjust, open the modal for stats/history/lots, or edit to recount and recast.
- Assign custom densities, categories, and ownership when needed; every restock/deduction routes through the Inventory Adjustment Service.
Global vs Org-Owned Items
The add-inventory drawer searches the global library. Selecting a global item locks identity fields (name, default unit, density) so every org speaks the same language. Typing past the suggestions creates an org-owned item that you can edit freely.
Step-by-Step: Add Inventory
- Open Inventory → Add Inventory Item or use the quick-add drawer on the list page.
- Search & select a global item or confirm creation of a new org-owned record. The banner shows whether it’s “Global-Locked” or “Org-Owned.”
- Complete the form: category, default unit, density override, perishable defaults, quantity, cost, supplier, lot, expiration, and storage location.
- Save. The confirmation modal offers an immediate restock dialog so you can add the first FIFO lot right away.
Manage Inventory from the List Page
- Quick Adjust opens a compact restock/spoil/recount form that still logs through Inventory Adjustment Service.
- Detail modal shows overview, stats, history, and lots tabs with buttons to restock or deduct.
- Edit screen unlocks recounts, recasts (adjust by a measured delta), density overrides, category assignments, and ownership toggles.
- History & attachments keep every adjustment auditable with supplier docs or COAs.
Restock, Deduct, and Audit
- All adjustments call Inventory Adjustment Service, which logs history + FIFO lots.
- Drawer payloads explain missing density/unit data so users can resolve issues without leaving the flow.
- FIFO lots show remaining quantity, expiration, and cost so audits are straightforward.
Image Placeholders
Drop screenshots for this section into /app/static/images/help/inventory/. The final onboarding tour can render them as a slideshow.
Add inventory-1.png under static/images/help/inventory/inventory-1.png
Add inventory-2.png under static/images/help/inventory/inventory-2.png
Add inventory-3.png under static/images/help/inventory/inventory-3.png
Inventory Adjustments & Recounts
- Restock, spoil, recount, and manual adjustments all flow through the same drawer so FIFO lots stay accurate.
- Quick Adjust on the inventory list captures supplier, cost, and reason codes in seconds.
- Every adjustment drops a note, attachment, and audit trail entry so you can prove what changed later.
Log Every Adjustment with Context
- Select Restock, Spoil, Damage, or Recount; each option prompts for reason codes, lot, and supplier.
- Provide cost per unit when restocking so valuation rolls forward automatically.
- Add notes or attachments (photos, invoices) so auditors see exactly why the change happened.
Use Quick Adjust from the List
- Open Inventory, hover a row, and choose Quick Adjust.
- Enter the delta (positive, negative, or zero for recount) and confirm the unit BatchTrack should apply.
- Submit to immediately update FIFO lots, unified history, and downstream costing.
Audit History & Alerts
- Every adjustment writes to Inventory → History with timestamps, user, quantity, and cost.
- Combined Inventory Alerts surface repeated recounts or spoilage so you can coach teams in real time.
- Expiration and reservation services read the same history, keeping warnings and holds consistent.
Image Placeholders
Drop screenshots for this section into /app/static/images/help/inventory-adjustments/. The final onboarding tour can render them as a slideshow.
Add inventory-adjustments-1.png under static/images/help/inventory-adjustments/inventory-adjustments-1.png
Add inventory-adjustments-2.png under static/images/help/inventory-adjustments/inventory-adjustments-2.png
Recipes & Variations
- Create recipes with ingredients, consumables, and container shortlists; store SOPs so they surface during planning.
- Understand bulk vs portioned yields—bulk is container-defined (lotions, candles), portioned is self-defined (bars of soap).
- Clone and unlock recipes to manage variations without rebuilding everything from scratch.
Step-by-Step: Create a Recipe
- Open Recipes → New Recipe and choose a production category (soap, candle, lotion, etc.).
- Set basics: name, description, yield, unit, and whether the batch is Bulk (container-defined) or Portioned (self-defined items like bars).
- Add lines: link ingredients to inventory/global items, log consumables, and shortlist containers/packaging that this recipe actually uses.
- Store instructions/SOPs so they appear in PlanSnapshot and batch records.
- Save and run a stock check from Production Planning when you’re ready to make a batch.
Variations, Clones, and Unlocking
- Clone a recipe to create new scents, colors, or volumes without rebuilding lines.
- Variations inherit containers and instructions but can override ingredients or yields.
- Unlock a recipe to edit it (actions are logged for traceability).
- Container shortlist ensures only relevant vessels appear during planning (no lipstick tubes when you’re making lotion).
Image Placeholders
Drop screenshots for this section into /app/static/images/help/recipes/. The final onboarding tour can render them as a slideshow.
Add recipes-1.png under static/images/help/recipes/recipes-1.png
Add recipes-2.png under static/images/help/recipes/recipes-2.png
Planning & Batches
- Plan Production builds an immutable PlanSnapshot, including intermediate components and target SKUs.
- Container auto-selection converts projected yield into vessel capacity; you can override it manually at any time.
- Batch screens track timers, extras, notes, costing, and the finish/cancel/fail workflows that control deductions.
Plan Config Options
- Batch type: choose Product (outputs sellable SKUs) or Intermediate (restocks component inventory like dough or syrups).
- Intermediate ingredients: add component batches that scale alongside the main batch.
- Product tab: pick the SKU/variant this batch will replenish.
- Containers required: auto-selection fills enough vessels to hold 100% of projected yield; you can disable auto and select manually.
- Unit alignment: ensure recipe yield units match container capacity units for precise auto-fill math.
- Stock check: must pass (or be explicitly bypassed) before starting the batch; drawer modals help resolve shortages.
Plan & Start Production
- Open Production Planning from the recipe page or sidebar.
- Select the recipe/variation, choose batch type, and set the scale factor.
- Configure intermediates, target SKUs, and container selections.
- Run the stock check; fix shortages or bypass with intent.
- Review the PlanSnapshot preview and submit to start the batch.
Batch In-Progress Page
- Header metrics show projected vs actual yields, portions, and container counts.
- Timers track curing/proofing tasks and alert the dashboard.
- Extras deduct additional ingredients/consumables/containers mid-run with reason codes.
- Notes & attachments capture QC observations.
- Costing pane breaks down ingredients, packaging, and (optional) labor.
Finish, Cancel, or Fail
- Finish: prompts for actual yield, container counts, portion data, and how inventory/product SKUs should be replenished.
- Cancel: rolls back all deductions and deletes batch rows.
- Fail: ends the batch but keeps deductions (for waste tracking) and requires a note.
Image Placeholders
Drop screenshots for this section into /app/static/images/help/planning/. The final onboarding tour can render them as a slideshow.
Add planning-1.png under static/images/help/planning/planning-1.png
Add planning-2.png under static/images/help/planning/planning-2.png
Add planning-3.png under static/images/help/planning/planning-3.png
Add planning-4.png under static/images/help/planning/planning-4.png
Costing & Profitability
- Every restock records cost per unit so FIFO lots always know their value.
- When you finish a batch, BatchTrack captures actual ingredient, consumable, and container spend.
- Dashboards and exports compare planned vs actual cost so you can price SKUs with confidence.
Cost-Informed Restocks
- When adding inventory or restocking, enter supplier and cost per unit.
- BatchTrack updates the lot value and total quantity immediately, so subsequent deductions pull the right cost.
- Use supplier notes to document negotiated pricing or bulk discounts.
Plan vs Actual Batch Costs
- PlanSnapshot holds the estimated recipe cost; the Finish Batch modal collects what really happened.
- Actuals roll into Batch → Costing so you can see ingredient, packaging, and optional labor totals.
- Products inherit their replenishment cost from finished batches, keeping SKU margins realistic.
Shareable Cost Insights
- Export batch stats or inventory history when accountants need an audit trail.
- Use Combined Inventory Alerts to highlight items trending toward high spoilage cost.
- Pricing updates can be tied to these reports so sales teams always quote profitable rates.
Image Placeholders
Drop screenshots for this section into /app/static/images/help/costing/. The final onboarding tour can render them as a slideshow.
Add costing-1.png under static/images/help/costing/costing-1.png
Add costing-2.png under static/images/help/costing/costing-2.png
Products, SKUs, & Reservations
- Define products and variants, then link batches to restock SKUs automatically.
- Reservations hold finished goods for wholesale/subscription orders so you never oversell.
- Store external IDs (Shopify/Square) on SKUs to keep ecommerce channels in sync.
Create Product Variants
- Open Products → All Products and create/select a base product.
- Add variants (size, scent, color) and map each to the containers/ingredients it consumes.
- Set reorder targets/thresholds so alerts fire before you run out.
- Link batches to variants when finishing production so finished goods automatically restock the right SKU.
- Use the reservations tab to hold finished goods for specific orders.
SKUs & Sales System Hooks
- A SKU = Product + Variant + Package Size + Quantity.
- When a batch finishes as “Product,” SKU inventory increases and ecommerce integrations can sync.
- Store Shopify/Square IDs on SKUs so connectors update the correct listings.
Image Placeholders
Drop screenshots for this section into /app/static/images/help/products/. The final onboarding tour can render them as a slideshow.
Add products-1.png under static/images/help/products/products-1.png
Add products-2.png under static/images/help/products/products-2.png
Add products-3.png under static/images/help/products/products-3.png
Labels, INCI Sheets, & Exports
- Generate INCI, candle, baker, and lotion labels directly from any recipe.
- Share HTML, CSV, or PDF exports with vendors, regulators, or production partners.
- Public tools mirror the same exports so prospects can preview before they sign up.
Recipe-Based Exports
- Open a recipe and click Exports.
- Select the label or sheet you need (soap INCI, candle label, baker sheet, lotion INCI).
- Download as HTML for quick viewing, CSV for spreadsheets, or PDF for print-ready sharing.
Public Tool Previews
- Prospects can visit
/tools, draft a formula, and jump straight into the matching export. - They can copy/paste label data during trials, then convert drafts into full recipes once they subscribe.
- Use this flow to collaborate with co-packers who only need the label data, not full app access.
Keep SKUs & Labels in Sync
- When batches finish and restock SKUs, the exports reflect the latest ingredient list and notes.
- Reservation records can include label links so fulfillment teams grab the right paperwork.
- Store regulatory notes in recipe instructions so they appear in exports automatically.
Image Placeholders
Drop screenshots for this section into /app/static/images/help/labels-exports/. The final onboarding tour can render them as a slideshow.
Add labels-exports-1.png under static/images/help/labels-exports/labels-exports-1.png
Add labels-exports-2.png under static/images/help/labels-exports/labels-exports-2.png
Public Tools & Help
- Share the /tools calculators so prospects can draft recipes before signing up.
- Drafts persist through /tools/draft and prefill /recipes/new once users authenticate.
- Use this page and the FAQ as the public knowledge base until the full onboarding tour ships.
Draft Recipes via Public Tools
- Visit
/toolsand pick a calculator (soap, candle, lotion, herbal, baker). - Use the inline typeahead to pull global ingredients/containers and enter quantities.
- Click Save to BatchTrack; the payload posts to
/tools/draft. - After signup or login,
/recipes/newdetects the draft and pre-populates every line.
Turn Drafts into Ready-to-Produce Recipes
- Save a draft after experimenting inside the public calculators.
- Log in and open Recipes → New Recipe; BatchTrack auto-detects the draft and fills ingredients, consumables, and containers.
- Tune instructions, notes, and yield, then move directly into production planning when you're satisfied.
Choose the Right Plan
- Compare tiers inside Billing → Plans to align features with your production volume.
- Seat counts, reservations, and analytics limits are spelled out so you can scale intentionally.
- Invoices and usage snapshots live in the same screen, keeping finance teams informed without exporting data.
Stay Informed & Get Help
- Use this help center plus the FAQ for day-to-day workflow questions.
- New feature callouts appear inline, and deeper release notes live under Docs → Changelog.
- If you need human support, submit a ticket from the in-app support link so the team sees your recent activity.
Image Placeholders
Drop screenshots for this section into /app/static/images/help/public-tools/. The final onboarding tour can render them as a slideshow.
Add public-tools-1.png under static/images/help/public-tools/public-tools-1.png
Add public-tools-2.png under static/images/help/public-tools/public-tools-2.png