ClearStock is live on the Shopify App Store.Install free →

← All blogs

Guides9 min read

Damaged stock: quarantine, record, and decide (without guessing at the loss)

A damaged inventory Shopify workflow: quarantine first, record the adjustment with a reason, then pick claim, vendor return, salvage, or write-off.

InventoryX is in development and not available today. ClearStock is the live Shopify app.

Most merchants treat damage as an accounting question — "what do I write off?" — and skip the two steps that make the answer accurate. The expensive failure isn't the cracked unit. It's the forty damaged units still marked sellable in Shopify, overselling from a bin by the packing bench while the decision waits for "later." The fix is a fixed order of operations: quarantine first, record second, decide third — because every good outcome (a claim that pays, a supplier credit, a salvage sale) depends on the record you make in step two.

Step one: quarantine before you decide

Shopify sells what's Available. Damaged units left in Available state aren't just miscounted — they're sellable, and they will sell, which is how damaged-goods refunds and apologies get made. The moment you identify damaged units, get them out of the sellable state:

  • Move the units into the Damaged unavailable state, if you want them to stay physically countable on hand but unsellable, or
  • Adjust the quantity down with the Damaged reason, if the units are leaving your sellable world for good.

Both actions are recorded — every inventory adjustment in Shopify keeps its date, who made it, and the quantity effect (Shopify Help Center, "Viewing inventory adjustment history," accessed November 2026). Which option you pick matters less than doing one of them the same hour you find the damage.

The physical habit that matches it: one labeled quarantine bin or shelf, per location. Damaged stock goes there and nowhere else, and nothing leaves it until step three has actually decided something. A quarantine bin with a two-week residency limit is a workflow. A "damage pile" that grows all quarter is a write-off you haven't priced yet.

Step two: record while the evidence is fresh

The record is the part everyone skips and everyone eventually needs. When you handle the damage, capture:

  • Date and SKU plus quantity — the adjustment history keeps this if you make the adjustment properly, but write it down anyway
  • Suspected cause — receiving, storage, transit, customer return, or unknown
  • Photos — Shopify's adjustment history doesn't store images, so keep them in a folder named by date and SKU
  • Packaging state — intact retail packaging changes the salvage math entirely

The built-in history is more capable than most merchants realize. The product-level view shows the last 180 days of adjustments with date, creator, reason, and the effect on each inventory state; beyond 180 days, the Inventory adjustment changes report can filter by SKU, location, staff member, app, and adjustment reason (Shopify Help Center, "Viewing inventory adjustment history," accessed November 2026). Using the standard reason — Damaged, rather than a silent quantity edit — is what makes all of that retrievable later.

Why the fuss? Because step three has five exits, and four of them are time-limited or evidence-dependent. Carrier claim windows are short. Supplier credit conversations go better with a photo taken the day the carton opened than with a shrug six weeks later. Insurance proofs of loss want dated documentation. The record you make in hour one is the option-making machine for every path after.

Step three: the decision tree

With units quarantined and recorded, walk the damage through five questions, in order:

  1. Did the damage exist before you took possession — a bad production run, wrong spec, QC the supplier should have caught? → Supplier path. Document it and pursue credit or a return-to-vendor arrangement; the claim conversation, word for word, is covered separately. The units stay on your books until the credit actually settles.
  2. Did a carrier cause it in transit? → Inbound (to your dock): freight damage claims have their own template and clock. Outbound (to a customer): run the customer damage claims workflow instead. Different carriers, different evidence, different windows — but both are "get money back" paths, not loss paths.
  3. Can the unit still do its full job after honest grading? → Sell-it path. Cosmetic-only flaws belong on a disclosed, discounted seconds listing — selling flawed units as B-grade stock covers grading, disclosure language, and clearance pricing. This is often the biggest-value exit on the tree.
  4. Is it partially usable — a set missing one piece, a pair with one damaged unit? → Salvage path. Split the components, use as free-with-purchase filler, or hold as repair stock. Salvage rarely pays much; its virtue is that it's decided in a minute and clears the bin.
  5. Is nothing recoverable? → Write-off path. The loss gets recognized somewhere specific — where it lands is the write-off vs write-down decision, and the answer isn't arbitrary. What you should not do is leave the units in limbo because the accounting word feels heavy.

Most merchants run damage through questions 3 and 5 and forget 1 and 2 — which is how perfectly recoverable money gets written off instead of claimed.

A worked example: the wet tote

An enamel pin brand. A storage tote sat under a slow roof leak; inside, 40 units of PIN-OWL-03 (owl hard-enamel pin, unit cost $2.10) have water spotting.

Quarantine, same afternoon: all 40 units move from Available into the Damaged unavailable state, reason Damaged, logged by the owner. On hand stays truthful; nothing sellable remains on the listing's promise.

Triage, next morning:

  • 24 units — spotting is on the backing card only; the pin and clasp are fine. Relabel the cards, disclose the flaw, sell at $7.00 against the $11.00 A-price. (This is the B-grade path — own SKU, own listing, photos of the actual spotting.)
  • 16 units — plating spotted, clasps seized. No honest price exists. Unsellable.

The entries (illustrative, educational only — tax treatment varies by jurisdiction and accounting method, so confirm the mechanics with your bookkeeper):

Unsellable 16 units. Cost basis: 16 × $2.10 = $33.60. Common treatment: debit COGS (or a separate inventory-loss line) $33.60, credit Inventory $33.60. The value leaves inventory and lands where your books keep losses.

B-grade 24 units. Value stays in inventory at cost: 24 × $2.10 = $50.40. No revaluation needed just because the selling price dropped — when they sell at $7.00, the margin reflects the flaw. The exception: if expected selling price falls below cost, merchants commonly write the units down to the lower figure rather than carry an inflated number.

If the supplier had shipped the damage and confirms a credit: the 40 units' cost, 40 × $2.10 = $84.00, comes back against inventory or as a credit memo once the supplier confirms — which is why the supplier path is walked before any discounting begins.

Note what made this cheap to decide: the record. Two adjustments, one triage note, four photos. The whole event closes in a day and every number in it can be defended.

What the record buys you later

  • Claims that pay — carrier and supplier conversations turn on dated, specific evidence, not on how fairly you describe the damage
  • A supplier damage rate — when the same supplier shows up in your adjustment history every quarter, the scorecard writes itself
  • Insurance proofs of loss — stock coverage responds to documentation, and the adjustments report is documentation
  • A month-end that reconciles — no mystery variances, because the damage left the system through the front door with a reason attached

And to be plain about tooling: InventoryX (in development) doesn't track condition or damaged states — it's read-only on quantities and has no condition fields — so this workflow runs on the quarantine bin, your photos, and Shopify's own states and history. That's enough. The hard part of damage handling was never software.

The 24-hour rule

Damage handled inside 24 hours keeps every option on the tree open. Damage discovered at a quarterly cleanup usually means the claim windows have closed, the supplier conversation has cooled, and the only remaining path is the write-off — the most expensive exit, chosen by default. Put the deadline on the bin itself: a quarantine shelf with a 24-hour triage tag costs nothing and prevents the pile that ends in silent losses.

Common questions

How do I record damaged inventory in Shopify? Move the units into the Damaged unavailable state, or adjust the quantity down selecting the Damaged reason — both are logged in the adjustment history with the date, who made the change, and the quantity effect. Pair the adjustment with photos stored elsewhere, named by date and SKU, and the record is complete.

What journal entry do I use for damaged goods? Illustratively: debit COGS (or a separate inventory-loss line) and credit Inventory for the cost of the unsellable units — 16 units at $2.10 is a $33.60 entry. Salvageable units usually stay in inventory at cost until sold. Practice varies by accounting method and jurisdiction, so treat this as bookkeeping education and confirm with your bookkeeper.

Is damaged inventory charged to COGS or an expense? Commonly to COGS or a dedicated loss line within COGS, since the cost attached to those units never converts to revenue — but the choice of account, and the tax treatment of losses, vary by jurisdiction and setup. This is an educational overview, not advice; the jurisdiction-specific answer belongs to your accountant.

Can I recover money for damaged inventory? Often, yes — supplier credit for pre-possession defects, carrier claims for transit damage (inbound and outbound run on different processes and windows), and insurance for larger losses. All three depend on the dated record and on acting inside the claim window, which is why quarantine-and-record comes before any deciding.

Should damaged customer returns be restocked? Not until they've been through the same tree: quarantine on arrival, grade honestly, then route to claim, seconds listing, salvage, or write-off. Auto-restocking returns is how damaged units re-enter sellable stock and generate the next refund. The customer-side dispute and refund mechanics are covered in the claims workflow.

Next step

Find the nearest thing you have to a damage pile, give it a label and a 24-hour triage tag, and clear it through the five-question tree this week — claim what's claimable, list what's sellable, and write off only what's truly gone. When a batch is beyond saving, the write-off vs write-down piece shows exactly where the loss should land so the books stay honest about it.