Go Live Checklist / FAQs for Mystery Boxes

Mystery Boxes are proven way to clear your extra inventory. With Profit bundles each and every customer order will be unique and different, a perfect recipe to go viral on social media. We have compiled a checklist of helpful tips from our experience working with brands in the past. So Let's begin!

  • Hide the Child Components : If you want to keep the mystery for your customers, here is guide on how to hide child components at various surfaces like emails, order status page etc.

    Oversell Protection and Low Inventory Automations : App has built in automation that kick in if inventory of child items in the product pool goes low, this is to protect you against overselling, while maximizing the number of sales per mystery box. Here is a guide for details.

    Managing Inventory for Mystery Boxes

    To better understand how inventory should be managed for mystery boxes and how the app prevents overselling while maximizing sales, refer to this guide:

    • How much inventory should I put per mystery box in Shopify Admin? As we have set up low inventory automations to protect against overselling, we recommend to put a comfortable number, if in between inventory of child items goes low, then app will put the parent mystery box out of stock, so that no further orders are received.
    • I am getting a great response, I want to sell even more mystery boxes : When due to low inventory automations, app puts parent mystery box product out of stock and sends a warning email (please make sure to add an email of the person as your contact email who can take actions in the app), if you still want to sell more, you can update the product pool with items that are in stock and again add new inventory to the mystery box from shopify admin.
  • My ERP / WMS / 3PL is not accepting mystery box orders : This usually happens when parent product is not created in these systems and fetched shopify orders with unknown lineitems are not accepted in here. In this case we recommend to try Shell Fulfillment.
    • With Shell Fulfillment my orders with discounts are not getting processed correctly? This usually happens when you have created discount codes that specifically target parent mystery box product only, when app replaces it with child components in the order, original discounts don't apply hence resulting in partially paid orders. We recommend to modify your discount codes to be applicable to both parent and child items.
    • With Shell fulfillment my orders are getting marked "Partially paid" : This could happen if the cumulative sum of retail price of child components is less than price of the parent item i.e when app replaces the parent with a set of child components, app can add discounts if price is higher but it can't increase the price of any item as that is not allowed in shopify ecosystem.
  • Understanding Mystery Box Item Selection

    If you want to control how products are selected from the pool for each order and ensure better variety in mystery boxes, you can review this guide:

  • Some orders are not getting processed by the app : some order categories like International multi currency orders, FB Instagram orders etc are uneditable in shopify. Meaning a 3rd party app like ours or even you as a merchant can't edit these orders. App handles this situation by creating a new associated order with child items and all the details from the original order to help you with the fulfillment.
  • How Recursive Selection Works in Mystery Boxes

    If your mystery box uses multiple rules or conditions for selecting items, the app uses recursive selection to intelligently pick available items from the pool so that orders can still be fulfilled smoothly. Learn more here:

  • How do I filter mystery box orders in my ERP / BI apps ? You can activate order tagging in the app, now app will add tags to all the order that will be processed by it. Here is guide for detail.
  • Can I upsell mystery boxes using my upsell app? Yes Sure, here is guide to set this up.
  • How can I make sure that the app does not pick any item from the product pool that is already part of the customer’s order? For this, there is a setting in the app called “Skip products already in the customer's order.” You can enable it by navigating to App Settings → Mystery Boxes → Mystery Box Composition Rules card and activating this option.
  • How can I make sure that taxes and duties are correctly processed by the app in shell fulfillment? Taxes and duties are automatically calculated by Shopify at checkout, as well as after order edits, based on your tax and duty settings. These settings can be applied across the store or on a per-product basis.

    To ensure correct processing of shell orders in mystery boxes, you need to make sure that the tax profiles for both the parent mystery box item and the child items are the same. Otherwise, after the parent mystery box is removed from the order and the child items are added during order editing, a tax mismatch can occur, which may result in partially paid orders.

  • How many high-volume orders can the app handle?

    Our servers are designed to handle high traffic and large order volumes, including campaigns from some of the biggest global brands. However, when processing Mystery Box orders, the main limitation can come from Shopify's API rate limits, rather than our servers.

    To process a Mystery Box order, the app needs to fetch certain real-time data from Shopify through API calls. Shopify applies API rate limits based on your Shopify plan. These limits determine how many API requests your store can make within a given period and can therefore affect how quickly high-volume orders can be processed.

    Based on our experience, the Shopify API limits roughly translate to the following Mystery Box order-processing capacity:

Shopify Plan Approx. Order Processing Capacity*
Basic / Grow Up to 13 orders per minute
Advanced Up to 25 orders per minute
Plus Up to 125 orders per minute
Enterprise Up to 250 orders per minute

If you are expecting high daily order volumes or a significant traffic spike during a campaign, sale, or product launch, we recommend contacting your Shopify's Point of Contact (POC) before the campaign.

Ask Shopify whether they can temporarily increase your store's API rate limits for the duration of the campaign. This can help ensure that your Mystery Box orders can be processed smoothly even during periods of unusually high traffic.

For more information about Shopify's API rate limits, see Shopify's API usage and rate limits documentation.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.