Savings Tracking

The Recovered KPI on your dashboard is the most direct measure of Shelfie's ROI: dollars of inventory you've actually moved since applying an action.

The formula

For every product with an active Shelfie action, Shelfie sums the revenue of order line items created after the action was applied:

recovered_value = Σ ( line_item.quantity × line_item.unitPrice )
                   for each order where order.createdAt > product.actionAppliedAt

The dashboard total is the sum of recovered_value across every actioned product. It updates on every sync (and in real-time once the orders/create webhook is registered — see Webhooks).

What "actionAppliedAt" means

When you click Apply on a product, Shelfie records a timestamp. Only orders placed after that moment count toward Recovered. Each subsequent sync re-reads the last 365 days of orders from Shopify and recomputes the total — so the number is always accurate, even if a webhook is missed.

Edge cases

Returns and refunds

Returns reduce the line-item revenue on the source order, which lowers the recomputed Recovered value on the next sync. Shelfie's recovered value naturally accounts for refunded units.

Discounts and promotions

unitPrice is the price Shopify recorded on the line item at checkout. For markdown actions, this is the discounted price — so the recovered value reflects the discount actually offered.

Re-apply after a price edit

Reverting an action clears the timestamp and resets recoveredAmount to $0 for that product. The next Apply starts a fresh tracking window.

Sync cadence

Recovered updates on every full sync (typically nightly or on demand via Re-sync). If you want near-real-time updates, register the orders/create webhook — this requires Protected Customer Data approval from Shopify.

Limitations

• Shelfie cannot distinguish organic sales from Shelfie-driven sales. If a product would have sold anyway, the action still gets credit. Treat the Recovered KPI as a generous estimate, not a strict attribution model.
• Order lookback is 365 days. Actions older than a year stop accruing new Recovered revenue.