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.

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 %}

Was this page helpful?