Shipping rate "description" not shown at checkout

Fulfillment & Inventory
1

Today, I have noticed a new and strange issue that the description field in the shipping rates array is not shown at checkout if the delivery date fields (min_delivery_date and max_delivery_date) are included in the rates. Have you noticed this?

The description becomes visible only when the delivery dates are removed from the rates array. This has been working without any issues for years. Starting from today, I noticed this issue in all stores I have checked.

{
"rates": [
  {
    "service_name": "canadapost-overnight",
    "service_code": "ON",
    "total_price": "1295",
    "description": "This is the fastest option by far",
    "currency": "CAD",
    "min_delivery_date": "2025-02-10 14:48:45 -0400",
    "max_delivery_date": "2025-02-15 14:48:45 -0400"
  }
]
}
1 Like
2

@Liam-Shopify Would you able to have a look at this please? Thanks

3

Hi @YOD_Solutions,

I have noticed the the same issue and joining your thread. Below I am giving our vision of the issue.

Context: our Carrier Service app is using REST API CarrierService - REST for providing Shopify checkout with shipping methods and rates. In the response we also return max_delivery_date, min_delivery_date and description fields.

Problem: as of very recently the description is not displayed at checkout if we include max_delivery_date, min_delivery_date in the response. It is displayed ONLY if we do not include max_delivery_date, min_delivery_date in the response. This is very odd behaviour as it used to display those params together without any issues.

The analysis of the flow indicates that the checkout interface gets this description from the Shopify’s backend via a GraphQL query, but it is not displayed anywhere in the interface. The checkout theme has not changed.

1 Like
4

Hey folks - our checkout team is looking into this! Will update here when I learn more. Thanks for flagging!

5

Update: this does look to be an issue on our side, our team are investigating further.

6

Thank you, Laim. It appears to be working now.

7

Glad to hear!! Let us know if you run into any other issues.

8

Hi @Liam-Shopify. I am currently running into this issue across multiple stores for my app. When I drop min_delivery_date and max_delivery_date from the call then it will show description, but when I include these fields it will only show the business day range.

Example Request Headers from Carrier Callback:

{ "user-agent": "Ruby", "content-length": "888", "accept": "*/*", "accept-encoding": "gzip;q=1.0,deflate;q=0.6,identity;q=0.3", "content-type": "application/json", "traceparent": "00-1415b1ba9a560188cd6a79f4172dd4fc-206ae9b3d74fa0d3-01", "tracestate": "ot=p:0;r:0", "x-cloud-trace-context": "1415b1ba9a560188cd6a79f4172dd4fc/2335936315365761235;o=1", "x-forwarded-for": "34.122.172.252", "x-forwarded-host": "asdfasdfasdf.free.beeceptor.com", "x-forwarded-proto": "https", "x-shopify-hmac-sha256": "olRk5y7c/qaQbCIuBpBmPe9mf1reDphWAUnAgjV9Ves=", "x-shopify-shop-domain": "derpyherps.myshopify.com", "x-shopify-timeout": "10000", "x-shopify-trace-context": "1415b1ba9a560188cd6a79f4172dd4fc/2335936315365761235;o=1", "x-shopify-trace-hint": "true" }

Do you know how to resolve this issue?

9

Hi @Jake_Krachman

Can you share the full call you’re making (replacing any sensitive info with sample data)?

10

Hi @Liam-Shopify .

Here is an example carrier callback for when we are seeing this issue.

The interesting thing about this is if I remove these 2 lines the description line will show:
“min_delivery_date”: “2025-06-18T20:43:47.972Z”,
“max_delivery_date”: “2025-06-24T20:43:47.972Z”,

This call took place on the store derpyherps.myshopify.com as a test. I ran a separate test with a new app on that same store and found the same results so it is happening across all apps on this store(and many others).

{
“rate”: {
“origin”: {
“country”: “US”,
“postal_code”: “94107”,
“province”: “CA”,
“city”: “San Francisco”,
“name”: null,
“address1”: “200 Townsend Street”,
“address2”: “”,
“address3”: null,
“latitude”: 41,
“longitude”: -87,
“phone”: “”,
“fax”: null,
“email”: null,
“address_type”: null,
“company_name”: “The Derpside”
},
“destination”: {
“country”: “CA”,
“postal_code”: “V3J 0K7”,
“province”: “BC”,
“city”: “Coquitlam”,
“name”: “Bart Simpson”,
“address1”: “567 Clarke Road”,
“address2”: null,
“address3”: null,
“latitude”: 49.2625639,
“longitude”: -122.8898651,
“phone”: null,
“fax”: null,
“email”: null,
“address_type”: null,
“company_name”: null
},
“items”: [
{
“name”: “New Art”,
“sku”: “12345”,
“quantity”: 1,
“grams”: 100,
“price”: 6797,
“vendor”: “test_test”,
“requires_shipping”: true,
“taxable”: true,
“fulfillment_service”: “manual”,
“properties”: {},
“product_id”: 7222979690539,
“variant_id”: 41063031177259
}
],
“currency”: “CAD”,
“locale”: “en-CA”
}
}

This is our response to the webhook:
{
“rates”: [
{
“currency”: “CAD”,
“phone_required”: false,
“min_delivery_date”: “2025-06-17T20:43:47.974Z”,
“max_delivery_date”: “2025-06-20T20:43:47.974Z”,
“days”: “2-5 business days”,
“description”: “Shipping: 32.82 CAD Duties, taxes and fees: 0.00 CAD”,
“total_price”: “3282”,
“total_price_usd”: “2407”,
“shipping_cost”: “32.82”,
“service_code”: “REDACTED-4829-42f9-9104-1e08290ada38”,
“service_name”: “International Express: Duties and Taxes Prepaid”,
“carrier”: “REDACTED”,
“carrierServiceCode”: “INTERNATIONAL_ECONOMY”,
“service_code_flcl”: “express”,
“provider”: “REDACTED”,
“shipping_cost_original”: 32.82,
“termsOfTrade”: “ddp”
},
{
“currency”: “CAD”,
“phone_required”: false,
“min_delivery_date”: “2025-06-18T20:43:47.972Z”,
“max_delivery_date”: “2025-06-24T20:43:47.972Z”,
“days”: “3-7 business days”,
“description”: “Shipping: 47.72 CAD Duties, taxes and fees: 0.00 CAD”,
“total_price”: “4772”,
“total_price_usd”: “3500”,
“shipping_cost”: “47.72”,
“service_code”: “REDACTED-55b8-4bc2-bbe5-e17f4da37c23”,
“service_name”: “International Standard: Duties and Taxes Prepaid”,
“carrier”: “REDACTED”,
“carrierServiceCode”: “APC.PRIPDC”,
“service_code_flcl”: “standard”,
“provider”: “REDACTED”,
“shipping_cost_original”: 17.78,
“termsOfTrade”: “ddp”
}
]
}

11

Hi folks - from digging into this more, it does look like a known limitation - you can display either the min/man delivery estimates or the description line, but currently not both. Our team are working on improving this but no ETA to share on this right now.