
If orders are marked fulfilled in your Shopify admin but customers say there is no tracking number, or the number is there but the link is dead, the cause is almost always in how the fulfillment was created. This guide is for store owners who use a courier, label or fulfillment app, and for the developers they brief. It works through the causes in the order we would check them, and every API behaviour mentioned is taken from Shopify’s own developer documentation.
Start by looking at the fulfillment itself
Open one affected order in the admin and look at the fulfillment card. You are looking for three things: is there a tracking number, is there a carrier name, and is there a link? Those map to the three fields on Shopify’s FulfillmentTrackingInfo object: number, company and url.
| What you see | Most likely cause |
|---|---|
| No number at all | Fulfilled without tracking, or an integration never sent it |
| Number, but not clickable | Carrier name or URL missing or not recognised |
| Number and link fine, but no customer email | notifyCustomer was false, or your email tool listens to the wrong event |
| Number fine, no live status | Carrier scans not yet available, or the carrier is not on Shopify’s status-update list |
| Number fine in the admin, nothing in your own system | Your integration reads the wrong field or event |
If the number is missing in the admin, you can add it by hand to get customers unstuck. Then fix the cause so the next hundred orders are right.
Cause 1: the customer was never notified
This one catches many integrations. In the fulfillmentCreate input, FulfillmentInput has a notifyCustomer field that defaults to false. If your app creates the fulfillment and omits it, no notification is sent, even though tracking is attached.
The update mutation behaves the same way. In fulfillmentTrackingInfoUpdate, if notifyCustomer is omitted, customers are not notified about this update or future updates to the fulfillment. So a common pattern is: the app creates the fulfillment first, adds tracking later, and never tells Shopify to email.
Decide deliberately. Send the email at creation if you have the tracking number then. If tracking arrives later, send it on the tracking update.
Cause 2: the tracking details are malformed
Shopify documents specific rules for the tracking input:
- Use
numberornumbers, not both. Useurlorurls, not both. urlrequiresnumber, andurlsrequiresnumbers.companymust match Shopify’s supported carrier list exactly. Capitalisation matters. A supported carrier name lets Shopify build the tracking links for you.- The same
companyapplies to every number in the call. - A
urlmust be a valid URI with a scheme and host. - For a carrier that is not on Shopify’s list, send the URLs yourself.
Shopify also warns that relying on format detection to make a number clickable can produce wrong links, and recommends sending both the company and the URL. If a customer clicks and lands on the wrong carrier’s page, this is the usual reason.
One more subtle point from the same documentation: setting a supported company builds the link, but it does not by itself make Shopify update the shipment status. Only carriers on a separate list get automatic status updates. So “the link works but the order page still says fulfilled” is expected for some carriers, and is not a bug.
Cause 3: the fulfillment was created in the wrong place
Modern fulfilment runs on fulfillment orders: each order is split into one or more fulfillment orders, each assigned to a location or fulfillment service. Shopify’s guide to fulfillment solutions describes the workflow: read the order’s fulfillment orders, check each one’s status and supported actions, then act.
Problems that follow from this:
- Wrong fulfillment order. One order can have several. If your app fulfils only the first, the others stay open and the customer sees a partial result.
- Closed fulfillment orders. Closed ones have no actions and cannot be changed.
- Not yours to fulfil. The guide says that as of API version 2024-10, you can only create fulfillments for merchant-managed locations or third-party services you own. Other third-party requests fail.
- Fulfilment service pending. For a third-party service, the app submits a request, the request status shows as submitted, and the service must accept it. Tracking comes after.
If the order is held at a third-party warehouse, the tracking number may not exist yet. Ask who owns the next step.
Cause 4: the API call failed quietly
Shopify’s GraphQL mutations return userErrors, and an HTTP 200 can still contain errors in that list. If your code only checks for a successful response, it will treat a rejected call as a success. Log userErrors every time.
Also check permissions. Both fulfillmentCreate and the tracking update mutation require one of these access scopes: write_assigned_fulfillment_orders, write_merchant_managed_fulfillment_orders or write_third_party_fulfillment_orders. The acting user also needs the fulfill_and_ship_orders permission. A missing scope is a clear error, not a silent failure, but only if you read the response.
A correct call looks like this:
# Creates a fulfillment with tracking and asks Shopify to email the customer.
# Replace the IDs and carrier details. Check the API version you use.
mutation CreateFulfillment($fulfillment: FulfillmentInput!) {
fulfillmentCreate(fulfillment: $fulfillment) {
fulfillment {
id
trackingInfo { company number url }
}
userErrors { field message }
}
}
{
"fulfillment": {
"notifyCustomer": true,
"trackingInfo": {
"company": "<name exactly as in Shopify's supported carrier list>",
"number": "<tracking number>",
"url": "https://example-courier.com/track/<tracking number>"
},
"lineItemsByFulfillmentOrder": [
{ "fulfillmentOrderId": "gid://shopify/FulfillmentOrder/1234567890" }
]
}
}
If you leave line items out of a pair, Shopify fulfils every item in that fulfillment order. To add tracking to an existing fulfillment, call the update mutation with fulfillmentId, trackingInfoInput and, if wanted, notifyCustomer: true. For multi-box orders, use numbers and urls and keep them in the same order.
Cause 5: the email is the problem, not Shopify
If Shopify shows tracking and the customer sees none, test the notification itself. The shipping confirmation email is a Shopify notification you can customise; our guide to customising Shopify order notifications covers that. If you use a third-party email tool for shipping emails, confirm which Shopify event it listens to. An email flow triggered on order placement cannot contain a tracking number that did not exist yet. Look for a trigger based on fulfilment.
Check the customer’s spam folder too, and remember tracking is also shown on the customer’s order history when accounts are enabled, because Shopify documents the URL as appearing in the admin, the shipping email and customer order history.
Cause 6: tracking exists, but the carrier has no scans yet
A valid number often shows nothing for a day or more, because the courier has not scanned the parcel. The number is correct; the data is not there yet. Do not send panicked emails; set expectations in your confirmation message.
A debugging routine
- Open the order and read the fulfillment card. Number, company, link.
- Query the fulfillment and read
trackingInfo. - Replay the API call in a development store and read
userErrors. - Confirm
notifyCustomerwas set the way you meant. - Check which fulfillment order was fulfilled and whether others remain open.
- Check the email trigger and the customer’s inbox.
- Fix the integration, then correct affected orders in a batch.
For the bigger picture of automating status updates end to end, read how to automate order status updates and tracking in Shopify. If you are writing the integration yourself, our guide to building a Shopify custom app with the Admin API and webhooks shows the structure. For courier-specific work, see our courier tracking automation service.
Frequently Asked Questions
Why does Shopify say “fulfilled” but show no tracking?
Fulfilled only means a fulfillment was created. Tracking is optional, so an integration that creates the fulfillment without trackingInfo leaves the order fulfilled with no number.
Why did the customer not get a shipping email?
By default the API does not notify: notifyCustomer on fulfillmentCreate defaults to false. Set it to true on creation, or on the tracking update mutation.
Why is the tracking number not clickable?
Usually the carrier name does not match Shopify’s supported list exactly, or no URL was supplied. Send the company and the URL together, as Shopify recommends.
Can I update tracking after the fact?
Yes. The fulfillmentTrackingInfoUpdate mutation updates the tracking on an existing fulfillment, with an optional notifyCustomer argument.
Does a supported carrier mean live status updates?
Not necessarily. Shopify documents that a supported company builds links, while automatic shipment status updates apply only to carriers on a separate list.
For a courier-specific example, see our Shopify DHL tracking setup and automation guide.
Conclusion
When a Shopify tracking number is not showing, the cause is usually one of a few things: the fulfillment was created without tracking, the customer was never notified, the carrier name or URL is wrong, the wrong fulfillment order was used, or an error in userErrors was ignored. Work through them in that order and log every response. If you would like help with this, CYPHEX can plan and deliver it for you, with one project lead as your contact. You can also see our Shopify development service.
Stock photography provided by Pexels under the Pexels License.
