Product return rate
By tracking return rates across your products, you can highlight low-return items on your storefront Amazon-style and boost customer confidence, filter products by return rate in your admin, or trigger Flow alerts when returns spike unexpectedly.
This is the per-product calculated rate between refunded items and the total quantity of items sold as seen in orders during the past 30 days (or 100,000 orders, whichever comes first). If no orders in the past 30 days mention the product, the return rate is set to 0.
The calculated return rate is rounded to the nearest 5% fold, meaning that a return rate of 0.01 is rounded to 0%, 0.12 to 10%, 0.18 to 20% and so on. This approach gives you easy-to-use admin options to identify size or quality issues, or to better the product description to set the right expectations for customers.
When comparing the calculated return rate using other reporting tools, consider our calculation is based on the number of orders in the past 30 days as opposed to 60 days or all-time sales
Details
- Name
espresso.return_rate
- Description
Metafield namespace and key
- Name
metaobject_reference
- Description
Metafield type. Using a metaobject reference instead of just a number allows for a better filtering experience in Shopify Admin.
- Name
product
- Description
Scope of Shopify object that owns the metafield
Example content
{
"value": 0.1,
"label": "10%"
}
When you initially enable this metafield, the individual product metafields will be set in a background task. If you have a large number of orders in the past 30 days, this may take anywhere from a few minutes to a few hours. Once the metafields are set, they will be updated in real-time
Flow trigger
Updates to this metafield fires a trigger that can used to start a Shopify Flow workflow.
- Name
product
- Description
A reference to the product that owns the variants
- Name
returnRate
- Description
The rounded return rate, one of 0.0, 0.05, 0.1, etc. up to 1.00
- Name
returnRateExact
- Description
The calculated return rate, using 2 decimal places
- Name
returnRateBefore
- Description
The rounded return rate value before the update. Use this to calculate the delta or direction between the two values
- Name
returnRateExactBefore
- Description
The calculated return rate value before the update. Use this to calculate the delta or direction between the two values
Example content
{
"product": "gid://shopify/Product/47953429430610",
"returnRate": 0.1,
"returnRateExact": 0.12,
"returnRateBefore": 0.15,
"returnRateExactBefore": 0.128
}
Example implementation
{% assign return_rate = product.metafields.espresso.return_rate.value %}
{% if return_rate.value < 0.2 %}
<h4>
Customers usually keep this item
</h4>
<p>
This product has fewer returns than average
</p>
{% endif %}