Shelfie

Troubleshooting

Common problems and how to fix them

Sync stuck on "Syncing..."

A sync that runs for more than 15 minutes is likely stuck. Reload the dashboard and click Re-sync to start a fresh run — the new sync supersedes the stale one.

If it happens repeatedly, your catalog may have an unusually large product (10,000+ variants) that's timing out. Contact support.

Action applied but Shopify didn't update

Check Shopify admin: the product status, price, or tag should reflect the action within seconds. If it didn't:

  1. Verify Shelfie has write_products permission — Apps → Shelfie → Manage permissions
  2. Check the dashboard for an error banner; details will appear there
  3. Try the action on a different product to isolate the issue

Revert doesn't restore original price

This means the product's price field was modified outside Shelfie after the action was applied. Shelfie's revert overwrites with the originally captured price, but if Shopify itself doesn't accept the mutation (e.g. variant deleted), revert silently fails.

Workaround: manually set the price in Shopify.

"Recovered" stays at $0 even after products sold

Check:

  1. Was an action applied to those products via Shelfie? (Not just sold organically — the snapshot only exists post-action)
  2. Has a sync run since the products sold? Recovered amount is recomputed at sync time
  3. Did inventory actually drop? If it stayed the same (e.g. only digital products or no inventory tracking), recovered stays at $0

Embedded app shows "401 Unauthorized"

Usually a stale session. Apps → Shelfie → Uninstall, then reinstall from the listing.

If the 401 persists, the app's SHOPIFY_API_SECRET may be out of sync with the Shopify Partner dashboard. Contact support.

Dashboard shows no products after sync

Three possibilities:

  1. Catalog is genuinely healthy — nothing has aged past 30 days
  2. Sync hasn't completed — watch the sync banner on the dashboard; refresh after a minute
  3. Order history is empty — products with no lastSoldAt age from createdAt. Brand-new stores won't have at-risk products for 30+ days

I deleted a rule but actioned products still show its name

Rules are referenced by ID. Deleting a rule doesn't affect already-applied actions, but new sync cycles will fall back to the catch-all rule for those products. Revert + re-apply if you want the new rule to take over.

← Rule Priority
Faq →