Why is my Freshly batch inventory not aligned with my inventory in Shopify?

Freshly builds on Shopify's inventory. It updates batches when orders come in and can update Shopify when you change batches, but it doesn't see stock changes made directly in Shopify or by other apps. That's the most common reason the totals drift apart. To keep them aligned, make all stock changes in Freshly.

Common causes

• Existing stock wasn't put into a batch. When you first start using Freshly, any stock already in Shopify needs to go into a batch. Open the product in Freshly and click Create batch on the Add unaccounted variant quantity (X items) to a batch banner. This creates a batch for the difference without changing Shopify. Split it into more batches if needed.
• Someone adjusted stock in Shopify. Freshly can't tell which batch a manual adjustment belongs to, so it doesn't apply it to any batch.
• Another app changed inventory. Inventory sync, ERP, warehouse, and POS apps can change Shopify quantities directly. These changes don't reach Freshly batches either.
• Freshly is set not to change Shopify. If Batch quantities added or adjusted on Freshly are reflected in Shopify. is turned off in Preferences > Inventory, adding, editing, or deleting batches won't change Shopify. The same applies when Adjust quantity in Shopify is unticked on a batch. See Adjusting inventory quantities in Shopify.
• Orders are still being processed. While batches are assigned to new orders, totals can be out for a short time. This usually corrects itself within a minute.

Find where the totals went out of sync

Compare the variant's history in Freshly with its history in Shopify. Find the first date where they disagree, then check who or what made that change in Shopify.

View the history in Freshly

1. In Freshly, go to Products and open the batch-tracked variant.
2. In the Inventory card, click View product inventory batch history.

3. Each row shows the change (Adjustment) and Shopify's quantity at that moment (Quantity). Work back through the list to the first row where the previous quantity plus the adjustment doesn't match the next quantity. That's roughly when an outside change happened.

View the history in Shopify

1. On the same Freshly page, click View variant in Shopify.
2. In the Inventory section, click View adjustment history.

3. Go to the date you found in Freshly and check the Created by column to see which staff member, app, or channel made the change.

Shopify shows the last 180 days here. For older changes, use the Inventory adjustment changes report. See Shopify's Viewing inventory adjustment history.

Fix the difference

• Shopify has more stock than your batches: open the product in Freshly and use Create batch on the banner, then edit the batch to set its expiry date.
• Your batches have more stock than Shopify: click the batch name, lower its Quantity, untick Adjust quantity in Shopify, and click Save.

If you'd like a list of all variants where Freshly and Shopify quantities differ, contact our team. We can export a CSV with both quantities so you can find and fix the gaps.