Plan: All plans Platform: Shopify
Overview
This guide explains how to sync the latest shipment checkpoint events from AfterShip to Shopify so your store always reflects the most recent shipment status. By pushing checkpoint updates directly into Shopify, you keep merchants and customers informed throughout the delivery lifecycle.
This integration uses Shopify’s GraphQL Admin API, specifically the FulfillmentEventInput object. For reference, see Shopify’s Admin API Documentation.
Note: Starting November 19, 2026, this feature is available on all AfterShip plans for Shopify stores. See Who can use it below to check whether it’s already on for your store.
Your Shopify store must have the write_fulfillments permission granted to AfterShip
New stores: This permission is granted automatically when you install the AfterShip app. No action is needed.
Existing stores: If you connected your store earlier, AfterShip may not have this permission yet. You don’t need to reinstall the app. Reauthorize your store instead:
Who can use it
Whether the sync is on for your store by default depends on when you connected your Shopify store to AfterShip and on your AfterShip plan.
Your Shopify store | Sync status | What to do |
Connected on or after November 19, 2026, including stores that reconnect | On by default | Nothing. The sync works automatically. |
Connected before November 19, 2026, on an Enterprise plan or above | On by default | Nothing |
Connected before November 19, 2026, on a plan below Enterprise | Off by default | Reinstall the AfterShip Tracking app from your Shopify admin (uninstall it, then install it again), or contact Support to turn it on without reinstalling. |
The sync works when all of the following are true:
Your Shopify store is connected to AfterShip.
AfterShip has the
write_fulfillmentspermission on your store (see Overview).The shipment comes from a Shopify order and matches a Shopify fulfillment.
How it works
AfterShip sends Shopify only the checkpoint events created after the sync is on for your store. AfterShip doesn’t sync earlier events automatically. If you need earlier events synced, contact Support.
AfterShip sends updates at a pace that leaves plenty of your store’s Shopify API capacity for your other apps. During peak traffic, some updates may reach Shopify slightly later than usual. AfterShip never drops updates, and each shipment’s updates always arrive in the correct order.
AfterShip syncs the same statuses on every plan (see Status mapping).
There’s no in-app setting to turn the sync off or choose statuses yet. If you need the sync turned off for your store, contact Support.
Primary use cases
Update Shopify whenever an AfterShip shipment checkpoint status changes.
Maintain a centralized view of fulfillment progress in Shopify.
Trigger Shopify automations using real-time shipping updates.
Field mapping
Important: Do not write back Expired events. AfterShip’s Expired status has no suitable Shopify equivalent field to map.
AfterShip Tracking Field | Shopify FulfillmentEventInput Field | Nullable |
checkpoint-datetime | happenedAt | Yes |
checkpoint-message | message | Yes |
checkpoint-status | status | No |
Status mapping
AfterShip Status | Shopify Status | Mapping Logic |
InfoReceived | LABEL_PRINTED | InfoReceived > LABEL_PRINTED |
InTransit | IN_TRANSIT | InTransit > IN_TRANSIT |
OutForDelivery | OUT_FOR_DELIVERY | OutForDelivery > OUT_FOR_DELIVERY |
AttemptFail | ATTEMPTED_DELIVERY | AttemptFail > ATTEMPTED_DELIVERY |
Delivered | DELIVERED | Delivered > DELIVERED |
AvailableForPickup | READY_FOR_PICKUP | AvailableForPickup > READY_FOR_PICKUP |
Exception- Failure | FAILURE | Exception > FAILURE |
Expired | N/A | Do not sync |
Pending | CONFIRMED | Pending > CONFIRMED |
Exception-Delayed | DELAYED | Exception > DELAYED |
Special case handling
1. Multiple tracking numbers per fulfillment
When a single fulfillment includes multiple tracking numbers with different statuses, choose the status with the highest priority from the list below.
Priority order (highest > lowest):
Exception
Pending
InfoReceived
InTransit
OutForDelivery
AvailableForPickup
AttemptFail
Delivered
Use the top-priority status as the one to write back to Shopify.
2. Multiple updates with the same status
Only write back to Shopify when the shipment’s checkpoint status actually changes.
Write back when the status changes, even if the new status is earlier (i.e., a regression)
Do not write back repeated events with the same status
This prevents unnecessary updates and API noise
What does it look like on Shopify
We do map with Shopify status
Label_PRINTEDandCONFIRMED, but Shopify will not display these two statuses on the page.After enabling the feature, we will start to push the tracking events to your Shopify stores, and they will be displayed on your order dashboard.
FAQs
1. Is this feature available on my plan?
Yes. It’s available on all AfterShip plans for Shopify stores.
2. Shopify orders aren’t updating. What should I check?
First, make sure AfterShip has the write_fulfillments permission. If it doesn’t, reauthorize your store from the connection list. If you connected your store before November 19, 2026, on a plan below Enterprise, the sync is off by default. Reinstall the AfterShip app or contact Support to turn it on. AfterShip syncs only shipments that come from Shopify orders.
3. Will orders that were already in transit or delivered be updated?
Not automatically. AfterShip syncs only new checkpoint events created after the sync is on. If you need earlier events synced for these orders, contact Support.
4. Can I turn off the sync or choose which statuses are synced?
Not in the app yet. Contact Support if you want the sync turned off for your store.
5. Why does an update sometimes show up in Shopify a little later?
To protect your store’s Shopify API capacity, AfterShip may briefly queue updates during peak traffic. AfterShip never drops them, and they always arrive in order.
Conclusion
This integration lets AfterShip push precise, real-time shipment updates into Shopify. By following the field mapping, status mapping, and prioritization rules above, you ensure reliable, clean, and automation-ready fulfillment events inside the Shopify Admin.
If you have any questions, contact our chat support team or email us at [email protected].

