> For the complete documentation index, see [llms.txt](https://help.palmstreet.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.palmstreet.app/seller/live-management/how-to-use-mystery-box.md).
# How to use Mystery Box
Mystery Box is Palmstreet’s platform management tool for sellers who want to add variety and engagement to their livestream sales. With Mystery Box, you create a pool of items, sell orders through auctions, and use Palmstreet’s system to automatically allocate one item to each buyer during a live display. Each completed order always corresponds to a real item. Sellers do not manually assign results.
{% hint style="info" %}
**Important:** Before using Mystery Box, sellers must review and follow Palmstreet’s official [Games Policy](https://help.palmstreet.app/guidelines-and-policies/game-policies), which outlines platform rules, compliance requirements, and seller responsibilities.
{% endhint %}
**Note:** Mystery Box is **not enabled by default** for live categories including **Reptile, Invertebrate, and Aquatic**. A limited number of sellers in these categories may be eligible to use Mystery Box with prior approval. To confirm eligibility or request access, please contact your Palmstreet representative.
## What Is Mystery Box?
Mystery Box allows sellers to run batches of orders where each completed order is allocated one guaranteed item from a disclosed item pool. Palmstreet manages the allocation process using system-controlled randomization to ensure consistency and fairness.
**Mystery Box is great for:**
* Adding variety to your show
* Encouraging audience participation
* Running themed or mixed-item sales
* Managing multiple auction rounds efficiently
## Rules When Using Mystery Box
Transparency is key for using our Mystery Box feature successfully. Make sure that you follow these rules:
* All possible mystery items should be displayed during your live. Here is a good example of a seller showing all options:
* Sellers must clearly illustrate what options are available to winners in the item listings by adding descriptive titles and descriptions. Here is an example of a seller using this correctly:
* In the show notes:
* Sellers must **clearly disclose all possible outcomes** a participant may receive.
* Sellers must **disclose the probability or odds** associated with each outcome.
* Disclosures must be **transparent, accurate, and easily visible** to participants before entry.
Emphasis should be placed on ensuring participants fully understand:
* What they can win
* The likelihood of each outcome
## How to Create a Mystery Box
{% stepper %}
{% step %}
### Create Your Mystery Box
* Tap “**+ Listing**” in your livestream to create a new listing.
* Select Auction as your selling mode.
* Scroll down and turn on “**Make it a Mystery Box**”.
* Tap “**Mystery box items**” to add the items that will be included in the item pool.
{% endstep %}
{% step %}
### Add Items to Your Mystery Box
* Add each item with a name and quantity.
* If an item should be highlighted, you can mark it as “**Hot item 🔥**”.
* The total number of items and Hot items will be shown at the top.
{% endstep %}
{% endstepper %}
## How to Run Mystery Box During Your Livestream
Mystery Box listings are marked with a **📦 icon**, making them easy to identify. If no image is uploaded, Palmstreet will display a default Mystery Box image.
### Start a Mystery Box
Once your Mystery Box listing is ready, you can start it directly from your livestream:
* **Start Auction:** Tap the **Shop** icon, find your Mystery Box listing, and tap **Start auction** to begin a round.
* **Item Allocation:** After a buyer completes payment, Palmstreet automatically allocates an item from the predefined pool and displays the assignment with a short animation visible to both the seller and the buyer.
* **Start Next Batch:** Tap Run Next to continue to the next batch using the remaining items.
### Manage and Edit Your Mystery Box Listing
* **Before the listing is pinned:** You can edit all details, including the items inside the Mystery Box.
* **After it has been pinned and some slots are sold:** You may still edit basic listing details, but the item pool is locked to ensure buyers receive items from the original configuration.
### View Your Mystery Box Details During the Live
During your livestream, you can tap the Mystery Box listing to view:
* How many items remain in the pool
* Which items are marked as Hot
* Which items have been allocated and which buyers received them
This helps you monitor progress and manage each batch smoothly.
## After the Stream: How to Check What Each Buyer Received
After your livestream ends, you can review all Mystery Box order results:
* Go to **Profile > Setting** ⚙️ **> My sales**.
* For Mystery Box orders, the product name will include the Mystery Box name, batch number, and the item allocated to the buyer.
## Hold the Mystery
Sellers can turn on **Hold the Mystery** to keep Mystery Box results hidden until you’re ready to reveal them during your LIVE show. Once items are claimed, results can be revealed one at a time or all at once, giving you more control over the reveal and helping build suspense and excitement throughout your show.
## How the Item Reveal Works
* Items are allocated by Palmstreet’s system using a predefined randomization process.
* Allocation occurs only after an order is completed and payment is successful.
* Each completed order receives one real item from the disclosed item pool.
* Sellers cannot manually select, swap, or influence item allocation.
## FAQ
Can buyers see all items in the pool?
Yes. Buyers can view the full list of items included in the Mystery Box, along with remaining quantities, before placing an order.
Can I run Mystery Box with Buy It now listing?
No. Mystery Box can only be offered through Auction listings.
Can I edit items after the auction starts?
No. Once a Mystery Box listing is pinned and an order is paid, the item pool is locked. You may still edit basic listing details, but not the items inside the box.
Are there any rules I need to follow when using Mystery Box?
Yes. Sellers must follow Palmstreet’s [Mystery Box Policy](https://help.palmstreet.app/guidelines-and-policies/game-policies/mystery-box-policy) when creating and managing Mystery Boxes. The policy explains allowed usage, restrictions, and seller responsibilities to ensure all Mystery Box orders are fulfilled fairly and compliantly.
