RuffRuff Order Bonus automatic recovery adds gift component products by editing an order when a gift that should have been distributed automatically on the online store is missing from the order.
Automatic recovery is disabled by default. Follow "Enable automatic recovery" on this page to configure it.
Distributing a planned gift after checkout without adding it to the cart is a separate feature. See Distribute gifts after the order.
A gift is added automatically when all of the following conditions are met.
Order: An online store order.
Gift: A simple or repeatable gift priced at zero.
Distribution method: "Automatic (add to cart automatically)." For a simple gift set to "Use settings page configuration," recovery applies only when "Automatically add gift to cart" is enabled.
The following distribution methods and order channels are excluded from automatic recovery evaluation.
Distribution method: Manual distribution, "After the order," and campaigns that do not target the online store.
Order channel: Sales channels other than the online store, including the Shop app, Buy Button, Instagram, POS, and external marketplaces. Draft orders and orders placed through subscription apps are also excluded.
Channels other than the online store are excluded even if the order went through Shopify checkout.
Choice gifts and gifts with a non-zero price are not added automatically. If such a gift qualifies and is determined to be missing, see the cases requiring review below.
Enable automatic recovery and the required additional permissions in the app settings.
(1) Open "Automation"
In the app admin, open Settings → Automation.
(2) Grant the required additional permissions
If "Additional permissions required" appears under "Post-order gifts," select "Grant permissions."
The additional permissions allow the app to read customers and locations, write orders and order edits, and write fulfillment orders.
(3) Enable automatic recovery and save
Enable "Recover gifts missing from online store orders" and select "Save."
For a simple gift set to "Use settings page configuration," also enable "Automatically add gift to cart" under Settings → Online store (Theme Extensions) → Gift campaigns.
To view automatic recovery results, add the "Post-order gift" block to order details in Shopify admin. The block is required only to display results; it does not start automatic processing.
(1) In Shopify admin, open any order detail
(2) At the bottom of the page, select "+ Block" from "Blocks"
(3) From the app block list, select "Post-order gift" and add it
(4) Select the pin icon on the added block to pin it
(5) Select "Save"
Caution: If you do not pin the block, it will not appear the next time you open the page.
Trigger: Processing runs in the background when an order is created.
Schedule: There is no fixed time or interval.
If more than 24 hours pass between receiving the order creation notification and evaluation, the gift is not added automatically and the order shows "Review required."
If the target order did not include a gift, the following processing runs automatically.
Component products: The component products are added to the order, rather than the gift product (bundle parent).
Price adjustment: A discount equal to the added line amount makes the line free. If the line is already free, no discount is added.
Fulfillment location: When possible, the fulfillment location for added products is matched to other products in the order. If this adjustment fails, the gift addition is not reverted.
Caution: Shipping is not recalculated. The store is responsible for any shipping difference caused by adding the gift.
If a temporary Shopify error prevents the gift from being added, the app handles it as follows.
Retries: If an attempt fails, the app retries, starting with a minimum interval of 30 seconds. It makes up to 5 attempts in total, including the first attempt.
If the gift still cannot be added: "Review required" appears in the order details.
"Added" appears in the "Post-order gift" block in the order details. Recovery results are identified as "Gift missing from the cart."
When automatic addition could add a gift incorrectly, the gift is not added and "Review required" appears.
A cancelled order.
An entirely fulfilled order.
An order that cannot be edited.
Choice gifts and gifts with a non-zero price are not added automatically. If they qualify and are determined to be missing, they require review. Manually distributed simple gifts are excluded from automatic recovery evaluation.
To find orders marked "Review required", see Finding Orders That Need Review from the Order List.
For how to fix each reason, see Order Details Shows "Review Required".
Check the reason under "Review required" and add the gift by editing the order if needed.
For campaigns that use "Customer login status" as a condition, order data cannot indicate whether the customer was logged in when purchasing.
If login status changes the result: The order shows "Review required."
If other conditions alone show that the order is ineligible: The gift is not processed.
If other conditions alone show that the order is eligible (OR condition): The gift may be added automatically.
Information used for evaluation: The app uses customer data linked to the order.
Orders placed while logged out: If the checkout email address matches an existing customer, Shopify includes the order in that customer's lifetime totals.
Prerequisite: Total order count and total amount spent are evaluated using values that exclude the current order.
If the issue remains after these checks, please contact us through the contact form.
When you contact us, please share the following information.
Occurred at
Target campaign name
Order number
Whether automatic recovery is enabled and the campaign's distribution method
What you already checked