Shopify-App
Fulfillment holds
Hold new orders with an invalid address until the customer fixes or confirms it, with an automatic release and a reminder email to you.
A fulfillment hold is Shopify's way of telling your warehouse "don't ship this yet". With the Fulfillment holds package, Address Validation iO holds new orders whose shipping address is Invalid and releases them by itself once the address is fixed, the customer confirms it or a time limit passes.
When an order is held
AVIO holds an order when all of these are true:
- Your shop has the Fulfillment holds package. See Plans.
- Hold fulfillment while the address is invalid is on under Settings → Fulfillment holds (off by default).
- You approved AVIO's permissions for fulfillment orders.
- The order is new and its address is Invalid. Needs checking is never held, and neither is an order that turns Invalid later.
- Its fulfillment hasn't started yet.
In Shopify the hold reason is "Incorrect address", with a note that AVIO releases it automatically. AVIO only ever releases its own holds, never yours or other apps'.
Customers don't see the hold. They get the usual correction request; see Order checks.
When the hold ends
| What happens | Reason shown in the order block |
|---|---|
| The address is corrected or checked again and is no longer Invalid (by the customer, in Shopify, or a re-check) | "address corrected" |
| The customer confirms the address | "customer confirmed the address" |
| The time limit runs out, by default 72 hours after the hold was placed | "timeout reached" |
If a re-check still says Invalid, the hold stays. Releases keep working when you switch the setting off, remove the package or pause AVIO. A new time limit only applies to holds placed afterwards.
If AVIO can't release a hold when the time runs out, because its permissions were removed or the app was uninstalled, the order shows "Release failed" and you must release it in Shopify. Release held orders before you uninstall.
Shopify doesn't tell AVIO when someone releases a hold by hand, so AVIO keeps showing "On hold" until its own release would have happened.
Email before the release
If the customer hasn't fixed or confirmed the address shortly before the time limit runs out, AVIO emails your shop's email address, by default 12 hours before the release. One email lists all held orders due in the same hour, each with the issue, the address, the release time in your shop's time zone and a link to the order in Shopify.
Orders that were corrected, confirmed or released in the meantime are left out; if none is left, no email goes out. Each listed order gets a history line saying the hold is released automatically soon.
The setting only affects holds placed after you change it. If the time before the release is longer than the hold itself (say 72 hours before a 48-hour hold), no email goes out.
Settings and defaults
| Setting (Settings → Fulfillment holds) | Default | Limits |
|---|---|---|
| "Hold fulfillment while the address is invalid" | Off | |
| "Release the hold after (hours)" | 72 | Whole hours, 1 to 720 |
| "Email me before the release (hours)" | 12 | Whole hours, 0 to 719 (0 = off) |
Without the package the page shows "Needs the Fulfillment holds package"; your saved values are kept and apply once you add it. If permissions are missing, the page shows "Fulfillment holds needs your permission". Click Grant access and approve in Shopify.
Where you see holds
- Admin order block: "Fulfillment on hold until the address is fixed" with the latest release date, later "Released" with the date and reason. Without permissions: "Fulfillment hold not possible: permissions missing".
- Logs → Orders: the "Fulfillment" column (On hold, Released, Hold not possible, Release failed) and the filter "Only orders on hold".
- Analytics: "Fulfillment holds", with held and released orders.
Troubleshooting
An order wasn't put on hold. Check the package, the switch and the permissions. Then check that the order was Invalid (not Needs checking) when it came in, its fulfillment hadn't started and AVIO wasn't paused. The order's history in Logs shows when a hold couldn't be placed.
You didn't get the email before the release. Check that the setting isn't 0, is below the release time and was saved before the hold was placed, and check your shop's email address in Shopify.
The address is still wrong, but the hold is gone. The time limit ran out, or someone released the hold by hand in Shopify.