Material Stock — Documentation
How to set the app up, and what it does when an order comes in.
Getting started (5 minutes)
1. Add your materials
Open Materials → Add material. A material is anything you consume to make a product: silver wire, coffee beans, fabric, a gift box, a label. Enter a name, a unit (g, ml, pcs, cm — any text you like), the cost of one unit, and how much you have in stock right now.
Set Alert at if you want to be warned before that material runs out. Leave it blank to skip alerts for that material.
2. Write a recipe
Open Recipes → Add recipe line. Pick one of your product variants, pick a material, and enter how much of it one unit of that variant consumes. Decimals are fine: 2.5 g of wire stays 2.5 g — nothing is rounded to a whole number.
A variant can consume as many materials as you need. Add one line per material.
3. Sell something
That is the whole setup. The next paid order deducts materials on its own. You can confirm it on the dashboard, which lists every deduction the app has made.
How deduction works
Shopify notifies the app when an order is paid. For each line item in that order, the app looks up the recipe lines for the variant sold and deducts
quantity in the recipe × quantity ordered
from each mapped material. Two units of a bracelet that uses 2.5 g of wire deduct 5 g.
Every deduction is logged with the order number, the material and the amount, and that log is what you see on the dashboard.
Redelivered webhooks do not double-deduct. Shopify retries a webhook if it does not get an answer in time. The log entry carries a unique key of shop + order + line item + material, so a repeat delivery is recognised and skipped rather than deducted again.
Orders are processed at payment, not at fulfilment. Unpaid draft orders and abandoned checkouts deduct nothing.
Cost and margin
The Costs page adds up the material cost of each variant from your own unit costs and compares it with the price you sell at, so you can see the real margin per product rather than a guess. Change a material’s unit cost and the figure follows.
The calculation covers materials only. It does not include labour, shipping, transaction fees, or overhead.
Low-stock alerts
When a deduction takes a material to or below its Alert at threshold, the app flags it in two places: a Low badge next to that material on the Materials page, and the Low stock panel on the dashboard, which lists every material currently under its threshold.
Alerts are shown inside the app. The app does not email or notify you outside Shopify admin.
Plans
- Free — up to 10 materials, every feature, no time limit. Not a trial.
- Pro — unlimited materials.
Recipes, deduction, cost and margin, and alerts all work on the free plan. Billing is handled by Shopify and appears on your normal Shopify invoice.
FAQ
Does it change my Shopify product inventory?
No. The app only reads from your store. Material stock lives inside the app; your Shopify product inventory is left exactly as Shopify manages it.
What happens to orders placed before I installed the app?
Nothing. Deduction starts with the next paid order. Enter your real material stock when you add each material and it will be correct from there.
What if I sell a product that has no recipe?
That line item is ignored. Only variants with recipe lines deduct anything, so you can start with one product and add the rest later.
What if a material goes below zero?
The app records the deduction anyway and shows the negative figure. It does not block the order — the sale already happened, and hiding it would make your stock look better than it is.
How do I restock?
Open the material and set Current stock to the new amount.
Can one material be used by several products?
Yes. Add a recipe line for each variant that consumes it. All of them draw down the same material.
Does the app read my customers’ data?
No. It reads the line items of a paid order — the variant and the quantity — plus the order number for the log. There is no customer record in its database. See the privacy policy.
What happens if I uninstall?
The access token for your shop is deleted immediately, and the rest of your shop’s data is deleted when Shopify sends the shop redaction request.
Support
Email tkym19811226@gmail.com. Include your store domain and, if it is about a specific order, the order number — that is enough to trace a deduction end to end.