Articles on: Mysbox

How to setup Mystery box


Step 1: Create mystery box


  1. On the Dashboard page, click Create product button



  • This opens Shopify’s product creation page.
  • Enter the correct title, price, description, and inventory for your mystery box.




  1. Once the product is created, go back to the setup flow
  2. In the dropdown, select the product you just created to link it as your mystery box.



  1. Click Continue to move to the next step (Set up items).


You will be automatically redirected to the box editor page. This page is the workspace where you will configure and manage your new box.



Step 2: Set up Box Items


  1. Choose Mystery box type, you can choose between:
  • Single-product box → A box with one randomly chosen item.
  • Bundle prize box → A box with multiple items, each from a different set.


  1. Configure the prize and their chances of being selected:



  • Under Prize #1, click Browse to add items that can appear in the box.
  • Quantity: For each item, enter the Quantity (how many boxes should include this item).
  • Chance: The system will calculate the Chance (%) for each product based on the assigned quantities.
  • Color: (Optional) Use Autofill chance color to automatically assign probabilities and colors. Or you can set your favorite color by clicking on the color.


Learn more on Understand the Chance Probability Mechanism in Mystery Boxes


Step 3: Choose the animation that appears when the customer opens the mystery box:


  1. Carousel:
  2. Drawing:
  3. None: No animation will be shown


Step 4: Launch and Preview


  • Click Save and preview the mystery box you just created by clicking the Preview button



Step 5: Enable theme app extension & Add blocks



  1. Enable Theme App Extension:


  • Click the Enable theme app extension button.
  • In the Theme editor, Mysbox list box item block is automatically added under Product information sections.
  • Drag and drop the block to the new position that you want in the product page.



  • Click on App embeds section > Find Mysbox App >Turn on the toggle to enable app
  • Click Save to apply changes



  1. Add blocks:


  • Go back the setup flow, click Add blocks
  • In Apps, click add Mystery box unboxing block to the Thank you page and Order status page:




Make sure to add the Mystery Box Unboxing widget to both the Thank You page and the Order Status page. If the widget is missing on either page, customers will not be able to see the unboxing animation and reveal their rewards.



  • Similarly, add the Unbox alert block to the Order page:




Hopefully this article has helped you. Things change all the time, so if you run into issues please don't hesitate to share them with us at support@getkoin.io or use the in-app live chat. We're happy to lend a hand 🤩


Updated on: 01/10/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!