Sometimes an order is completed without the gift being added to the cart, even though the gift's conditions were met. Automatic Gift Recovery detects these orders and adds the missing gift after the fact by editing the order.
Not every missed gift distribution is eligible for automatic recovery. An order is only eligible when all of the following conditions are met.
Condition | Details |
|---|---|
Gift price | Only free (¥0) gifts are eligible. Paid gifts are not eligible. |
Gift type | Only "Preset Gift (Simple Gift)" and "Repeatable Gift" are eligible. "Choice Gift" is not eligible, since it requires the customer to make a selection. |
Order channel | Only online store orders are eligible. POS orders, draft orders, and subscription app orders are not eligible. |
If an eligible order doesn't correctly include the gift, the following happens automatically.
1. The gift's component products are added to the order using the Order Edit feature. 2. A 100% discount is applied to the added products, bringing their price to ¥0. 3. Where possible, the shipping destination (fulfillment location) of the added products is matched to the other items in the order.
Shipping costs are not recalculated. If adding the gift results in a shipping cost difference, the store bears that cost.
If the gift-add process fails due to a temporary Shopify-side error (such as a network error), the system automatically retries up to 5 times at set intervals. If the gift still can't be added after retrying, the order is flagged as "Action Required" on the order details page, the same as the other cases below.
If there's a risk of adding the gift incorrectly, the system does not act automatically, and the order details page shows "Action Required" instead. For how to handle each reason, see the related article "Order Shows 'Action Required' Status."
Campaigns that use "Customer Login Status" as a targeting condition may see results from this feature that differ from what you'd expect.
On the online store, this condition is evaluated based on whether the customer was actually logged in at the time of the order. This feature, however, evaluates it based on whether a customer record is linked to the order. Because of how Shopify works, an order placed without logging in can still end up linked to a customer record afterward (for example, based on the email address used) — so an order that was excluded from gift distribution on the storefront may be judged eligible by this feature.
Please keep this difference in mind if you use "Customer Login Status" as a targeting condition.
To use this feature, you need to (1) enable the recovery feature and (2) add the block to the order details page.
This feature is disabled by default. Enable it as follows.
1. Open "Settings" → "Automation" in the app admin. 2. Check "Automatically recover missed gift distributions" under "Post-order Gift."
Enabling this feature requires granting additional permissions related to editing and reading orders. If permissions are missing, instructions will appear on the settings page — please follow them to grant access.
The results of recovery (such as "Action Required") are shown in the "Post-order gift" block on the Shopify admin's order details page. This block is not shown by default, so add it as follows.
1. In Shopify admin, open the details page for any order. 2. In the "Blocks" section near the bottom of the page, click "+ Block." 3. Select "Post-order gift" from the list of available app blocks and add it. 4. Click the pin icon on the added block to pin it. 5. Click "Save."
If you don't pin the block, it will no longer appear the next time you open the page.
Order Shows "Action Required" Status Finding Orders That Need Review from the Order List