Quickstart
From install to your first recovered product in 5 minutes
By the end of this guide you'll have:
- Your full catalog synced and every product scored by aging
- A clear view of which products are dead stock and how much value is tied up
- Applied your first recovery action — with the ability to undo it instantly
1. Install Shelfie
Open the Shelfie listing on the Shopify App Store and click Add app.
Approve the requested permissions:
| Permission | Why Shelfie needs it |
|---|---|
| Read/write products | To apply markdowns, sale badges, tags, and status changes |
| Read orders | To detect when a product last sold and attribute recovered revenue |
| Read/write inventory | To read stock levels |
2. Run your first sync
After install, Shelfie opens the dashboard with a Sync Products button. Click it.
The sync does three things:
- Pulls your full product catalog from Shopify
- Looks back 365 days of order history to find each product's last sale date
- Assigns every product a risk level based on days since last sale
What you'll see while it runs: a progress banner showing products synced. For most stores this takes under 60 seconds. Stores with 5,000+ products may take a few minutes.
3. Read the dashboard
After sync, the dashboard shows four KPIs at the top:
| KPI | What it means |
|---|---|
| Value at Risk | Total inventory value in products aging past your warning threshold |
| Dead Stock | Count of products past your dead threshold (default: 30 days) |
| At Risk | Products between warning and dead — heading in the wrong direction |
| Recovered | Real order revenue from sales after you applied a Shelfie action (starts at $0) |
Below the KPIs is a table of every at-risk product. Each row shows the product, its aging (days since last sale), risk level, the action queued for it, and its current status.
Don't be alarmed if you see a lot of products flagged. Most stores discover they have more aging inventory than they realised — the default 30-day dead threshold surfaces products that have genuinely stalled.
4. Apply your first action
Find a product you're comfortable testing on — ideally one that's already been sitting unsold for a while.
Click Apply on that row. Shelfie will show you exactly what will change:
- Which action (e.g. "20% Off Markdown")
- Old price → new price
- Any tags or status changes
Confirm, and Shelfie pushes the change to Shopify. The row updates to show the action is applied and the original price is saved.
To undo it: click Revert on the same row. The original price is restored instantly.
5. Understand the default rule
Shelfie comes with one pre-created catch-all rule:
- Scope: every product in your store
- Warning: 7 days since last sale
- Danger: 14 days
- Dead: 30 days
- Action: 20% Off Markdown
This is a safe starting point. You can change the thresholds, swap the action, or add more specific rules (per vendor, collection, tag) in Settings → Rules.
6. (Optional) Add a more specific rule
Go to Settings → Rules → Add Rule. Try a vendor rule:
- Scope type: Vendor
- Select a vendor from your catalog
- Set your preferred thresholds (e.g. 14 / 30 / 60 days for slower-moving vendor products)
- Assign an action (or create a new one)
Re-sync after saving. Products from that vendor will now use the new rule instead of the catch-all.