Shelfie

FAQ

Frequently asked questions

Will Shelfie change my product prices without asking? **No — never.** This is the most important thing to know about Shelfie.

When a product hits its dead-stock threshold, Shelfie queues it as a pending suggestion. Nothing happens in Shopify at that point. You see the suggestion on the dashboard, decide which products you want to act on, and click Apply. Only then does anything change.

Shelfie is not an automated discounting tool. It will never change a price, tag, or product status while you're not looking.

Is it safe to install? Will it immediately do something to my store? Yes, it's safe. Installing Shelfie only reads your catalog and order history — it doesn't write anything until you explicitly click Apply on the dashboard.

The permissions you approve look broad ("write products") but Shelfie only uses that permission when you trigger an action. You're in complete control.

What exactly happens when I click Apply? Shelfie executes the action configured for that product's matching rule — for example, a 20% markdown.

Specifically:

  1. It reads the product's current price (and compareAtPrice, tags, status)
  2. Saves a snapshot of that original state
  3. Applies the configured change (e.g. sets price to 80% of original)
  4. Records the timestamp — this is the start of the Recovered revenue window

The original price and state are saved so Revert can undo it exactly.

Can I undo an action? Yes. Click **Revert** on any applied product row. Shelfie restores: - Original price and compareAtPrice for every variant - Original product status (if archived or unpublished) - Original tags (removes any tag Shelfie added) - Original collection membership (removes from collection Shelfie added it to)

Revert takes effect in Shopify immediately. After reverting, the product's Recovered amount resets to $0.

What if I manually changed a product's price after applying an action? Shelfie's revert will restore the price it captured *before* the action — not your manual change.

Example: Product was $100. You applied a 20% markdown (price becomes $80). Then you manually changed it to $75. If you revert, Shelfie restores it to $100 (the original snapshot), not $75.

If you've made manual changes after applying, be aware of this before reverting.

My thresholds seem too aggressive — products are being flagged after just 7 days The default warning threshold is 7 days, which is intentionally low to surface slowing products early. For most stores, you'll want to adjust this based on your typical sell-through rate.

For stores where products naturally sell over weeks or months (e.g. furniture, premium goods), change your catch-all rule thresholds to something like 30 / 60 / 90 days. Go to Settings → Rules → catch-all and update the Warning / Danger / Dead days.

Nothing is showing up in the dashboard after sync Four possibilities:
  1. Everything is genuinely healthy — no products have aged past your lowest threshold yet
  2. Sync hasn't finished — watch the progress banner; larger catalogs take a few minutes
  3. Thresholds are too high — if warning is set to 90 days, you won't see products until they're 90 days old
  4. New store / no order history — products age from their creation date if never sold. Brand-new stores may not show anything for weeks

Try lowering your warning threshold temporarily to see what's in your catalog.

The Recovered KPI is $0 even though products sold after I applied an action Check:
  1. Was a sync run after the products sold? Recovered is recomputed at sync time (and in real time on Pro via the orders webhook). If you haven't synced since the sales, click Sync.
  2. Were the products sold via Shopify orders? Recovered only counts Shopify order line items. Sales via external channels (manual invoices, draft orders not converted) won't be counted.
  3. Are the products still applied? If you reverted them, their Recovered resets to $0.
  4. Is order access approved? Shelfie needs the read_orders permission and Shopify's Protected Customer Data approval to read orders. Check the dashboard for a permission warning banner.
I changed an action's percentage. Why didn't my applied products update? Applied products keep the parameters they were applied with — Shelfie never silently re-pushes price changes to products.

After you edit an action config, affected rows are flagged Out of date in the dashboard (yellow Action badge). Click Reapply on individual rows, or include them in a bulk Apply to update them all at once.

Can I protect certain products from ever being actioned? Yes — two ways:
  1. Product rule (priority 100): Create a rule scoped to the specific product with very long thresholds (e.g. 9999 days). It will never fire.
  2. Tag rule (priority 80): Create a tag rule for a tag like no-discount with very long thresholds. Tag any products you want protected. The tag rule overrides the catch-all for all tagged products.

The tag approach is more flexible because you can protect/unprotect products by adding/removing a tag without touching the rule.

Why can't I delete an action config? Deletes are blocked while any product still has that action applied or queued as pending — the confirmation dialog reports how many products are affected. Revert those products (or reassign their rule to a different action) first, then retry the delete.
Does Shelfie work with multi-currency stores? Yes. Prices are stored in your shop's default currency. Markdowns operate as percentages, so they translate cleanly to alternate currencies via Shopify Markets.
Does Shelfie work with subscription products? Markdown, sale badge, and clearance actions work on subscription product variants. Archive and unpublish may interfere with active subscriptions — test on one product first and verify your subscription app's behaviour before bulk-applying.
What happens to my data if I uninstall? Shelfie removes its session and webhooks from Shopify. **Applied actions are NOT auto-reverted** — price changes, tags, and status changes remain on your products. Revert any actions you want to undo *before* uninstalling.

Your Shelfie data (rules, action configs, sync history) is deleted from our servers within 90 days of uninstall per our Privacy Policy.

How often does sync run automatically? A **full catalog sync** (products + orders + aging + Recovered KPI) runs only when you click **Sync Products** or **Re-sync** on the dashboard. Most merchants do this 1–2× per week.

Per-product updates happen in the background without a full sync:

  • products/update webhook — when a product changes in Shopify (title, price, inventory, tags)
  • orders/create webhook (Pro) — real-time Recovered attribution for that order's line items

These do not recompute aging for your whole catalog. For that, run a manual sync.

If a sync fails, do I have to start over? Not if you retry within **30 minutes**. Shelfie saves a pagination checkpoint after each page of products. Click **Re-sync** and it resumes from where it stopped — already-imported products are not re-fetched from Shopify.

After 30 minutes the checkpoint expires and the next sync starts from page 1. Products already in your database are updated (upserted), not duplicated.

Does Shelfie support incremental sync? **Partially.**
  • Resumable sync: if a manual sync fails mid-run, retry within 30 minutes to continue from the last page (not a full re-import).
  • Per-product webhook updates: when a single product changes in Shopify, Shelfie updates that row — but does not refresh order history or aging for the whole catalog.
  • Not yet: a sync that only fetches products changed since lastSyncAt (delta sync). Every completed manual sync still walks the full product list from Shopify.

For catalog-wide aging and the Recovered KPI, run a manual sync.

Can I export my data? CSV export is on the roadmap. For now, email [support@cooe.au](mailto:support@cooe.au) and we'll send you a data export.
What's the difference between Free, Growth, and Pro? See the [pricing page](https://shelfie.cooe.au/pricing) for the full breakdown. In short:
  • Free — 500 SKUs, 1 rule, manual sync
  • Growth — 5,000 SKUs, unlimited rules, bulk apply/revert ($9/month)
  • Pro — unlimited SKUs, real-time order attribution, tag and location rules ($29/month)

All paid plans include a 14-day free trial.

← Troubleshooting
Privacy →