When Automatic Gift Recovery is enabled, orders where a missed gift distribution couldn't be automatically resolved show an "Action Required" badge and the message "The following campaigns need review" on the order details page. This article explains why this appears and how to respond.
This article covers orders where the gift's conditions were met but the gift wasn't reflected in the order. If the conditions weren't met in the first place, see "Gift Not Distributed" instead.
These buttons only record that you've reviewed the order — they do not re-add the gift or re-evaluate eligibility. To actually deliver the gift, you need to edit the order yourself following the guidance below.
Clicking "Mark as Resolved" records that you've handled the order. If you've determined that manual action isn't needed, click "Mark as Not Needed" instead. If you click either by mistake, you can always undo it with "Revert to Action Required."
When this appears: Shown when the gift product had zero inventory, so none could be added.
What to do: If you want to add the gift, restock it and edit the order to add it manually. If it's not needed, click "Mark as Not Needed."
When this appears: Shown when, for example with a repeatable gift, inventory wasn't enough to cover the full required quantity, so only part of it was added.
What to do: If you want to add the rest, restock and edit the order to add the remaining gifts manually. If not needed, click "Mark as Not Needed."
When this appears: Shown when the order already contains a product identical to the gift (for example, the customer separately purchased the same item), making it impossible to tell whether the gift was already distributed.
What to do: If you determine it wasn't distributed and want to add the gift, edit the order. If you determine it was already distributed, click "Mark as Not Needed."
When this appears: Shown for repeatable gifts when the actual quantity in the cart may be lower than the quantity calculated from the order.
What to do: If there's a shortfall, edit the order to add it. If the quantity is fine, click "Mark as Not Needed."
When this appears: Shown when multiple gift campaigns target the same gift product, making it impossible to uniquely determine the quantity to add (unlikely to occur in normal operation).
What to do: If you want to add the required quantity of gifts, edit the order. If not needed, click "Mark as Not Needed."
When this appears: Shown when the gift campaign's distribution method is set to "Manual," which is excluded from automatic addition by design.
What to do: If you want to add the gift, edit the order. If not needed, click "Mark as Not Needed."
When this appears: Shown for "Choice Gift" type campaigns, which require the customer to make a selection and are therefore excluded.
What to do: Confirm the customer's preference; if you want to add it, edit the order. If not needed, click "Mark as Not Needed."
When this appears: Shown for campaigns with a customer-related condition (such as a customer tag or membership tier) when no customer record is linked to the order (for example, a guest checkout).
What to do: If the conditions are met and you want to add the gift, edit the order. If not, click "Mark as Not Needed."
When this appears: Shown when the gift campaign's settings were changed after the order was placed, making it impossible to accurately reproduce the conditions as they were at that time.
What to do: If the conditions at the time of the order were met and you want to add the gift, edit the order. If not, click "Mark as Not Needed."
When this appears: Shown when part of the campaign's targeting conditions is a type this automatic evaluation can't assess.
What to do: If the conditions are met and you want to add the gift, edit the order. If not, click "Mark as Not Needed."
When this appears: Shown when more than 24 hours passed between the order being placed and the gift evaluation running. This isn't an error — it's a precautionary stop because too much time had passed to safely add the gift automatically.
What to do: If you want to add the gift, edit the order. If not needed, click "Mark as Not Needed."
When this appears: Shown when Shopify's order-edit feature returned a clear error. In this case, the system does not automatically retry.
What to do: If you want to add the gift, check the order's status and edit it. If not needed, click "Mark as Not Needed."
When this appears: Shown when the order had already been fulfilled by the time the gift was detected. Since delivering the gift would require a separate shipment, this is not handled automatically.
What to do: If you want to ship the gift separately, edit the order. If not, click "Mark as Not Needed."
When this appears: Shown when the order's status (for example, a refund or partial cancellation) prevents editing.
What to do: If needed, consider options such as a refund or reshipping the item.
When this appears: Shown when the gift product configured on the campaign can't be found — for example, if it was deleted.
What to do: Check the gift product settings on the campaign.
When this appears: Shown when the gift itself has no component products configured to distribute.
What to do: Check the component product settings on the app's Gifts page.
When this appears: Shown when a gift product that should be distributed for free has a price other than ¥0.
What to do: Check the gift product's price settings.
When this appears: Shown when the order itself was canceled before or after the evaluation ran.
What to do: No action needed.
When this appears: Shown when the gift-add process failed due to a temporary Shopify-side error (such as a network error) and all 5 retry attempts were unsuccessful.
What to do: If you want to add the gift, edit the order. If not needed, click "Mark as Not Needed."