Troubleshooting — common questions

The 12 most common things merchants ask in their first month of using BulkFlow. If your problem isn't here, email support@bulkflow.app.

"BulkFlow says my Shopify isn't connected"

In Settings → Connection, click Reconnect. You'll be sent through the Shopify consent screen again. After approval, all webhooks re-register automatically and the connection should show green.

If reconnect repeatedly fails, your Partner Dashboard app config may be out of sync with what BulkFlow expects. Contact support.

"I see 'Demo mode' everywhere — how do I turn that off?"

You're in demo mode (mock_mode=true). It's enabled by default for safety so you can poke around without writing to your real Shopify store. To leave demo mode:

Settings → Mode → toggle "Demo mode" off
Confirm
BulkFlow now writes real inventory changes to Shopify

If you JUST installed via OAuth, demo mode should have flipped off automatically. If it didn't, something's misconfigured on our end — please contact support.

"Webhook Health shows MISSING for some topics"

Click Re-register webhooks. Takes ~5 seconds. If the same topic stays MISSING after re-register, it's usually a Shopify scope problem — see the Webhooks doc for diagnosis steps.

"An order was paid but no deduction happened in BulkFlow"

Most common cause: the variant isn't bound to a bulk pool. Go to Shopify Health → New variants detected. If the variant is there, click "Bind to pool" and pick the correct bulk pool.

Less common: the variant has pack_size=0 or pack_size missing. Fix from Items → click item → Edit variant.

"BulkFlow keeps saying 'Multi-Location requires Plus' even though I just downgraded"

This is suppressed for 5 minutes after a downgrade. If you're still seeing it after 5 minutes, dismiss the banner once — it won't come back for 7 days (or until you click "I only use one location" to acknowledge permanently).

"I downgraded but lost data"

You didn't lose it. Multi-location data is consolidated on downgrade — pools from secondary locations are summed back to the primary. The per-location split is hidden, not deleted. Re-upgrade and click Settings → Multi-Location → Pull from Shopify to restore the per-location split.

"I upgraded but my new features aren't showing"

Hard-refresh the app (Cmd/Ctrl+Shift+R). The plan upgrade is real but your browser may be showing cached navigation. If after a hard refresh it still doesn't unlock, go to Settings → Connection → Refresh plan which re-queries Shopify.

"I can't find the [feature X] you mentioned"

Most likely cause: it's gated behind a higher tier than you're on. The plan comparison page (Billing) shows what's locked.

Less common: it requires Multi-Location to be set up first. Open Settings → Multi-Location Inventory and run the setup wizard.

"My catalog digest emails aren't arriving"

In order:

Check your spam folder
Check Settings → Catalog Digest is enabled
Check the recipient email is correct (yes, really)
If your email is on Gmail and you JUST signed up, Gmail's spam filter is aggressive on new senders for the first ~30 days. Mark one email as Not Spam and future ones will deliver.

If after all that it still doesn't arrive: support@bulkflow.app with the recipient email and an approximate time you expected the digest.

"I see 'Test charge' on my billing approval screen"

That's correct. You're installing on a Shopify development store, which auto-flips Billing API into test mode. No real money is charged. When you install on a real production store, the test badge disappears and real charges happen.

"Reconciliation says everything has 0 drift, but I know my counts are wrong"

That means BulkFlow and Shopify agree — but they may both be wrong relative to physical reality. Run a Physical Count instead, which compares against your shelf (not Shopify). Physical Count writes corrections to BulkFlow, then Reconcile pushes those corrections to Shopify.

"I broke something. Can I undo it?"

Depends what:

Bad CSV import — Pro+ can reverse it in 1 click from Import History
Bad reconciliation — Pro+ can reverse it in 1 click from Movements (filter reason=reconciliation)
Bad manual adjustment — Apply an offsetting adjustment with reason "correction"
Deleted a bulk pool — Soft-deleted items live in Archive for 30 days; restore from there
Uninstalled BulkFlow entirely — Reinstall within 48 hours and your data is preserved. After 48 hours, Shopify's GDPR shop/redact webhook fires and we permanently delete the shop's data.

Still stuck?

In-app Feedback button (bottom of the sidebar) — files directly to our team's dashboard
Spotted an error in Shopify Health → Recent Errors? Click it and hit Report to BulkFlow support — you'll see a live ticket status (Reported → Acknowledged → Resolved) as we work it
support@bulkflow.app — typically replied to within one business day
Getting help — every support channel explained
Quickstart — for first-week-getting-going questions