> For the complete documentation index, see [llms.txt](https://docs.qrbase.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qrbase.xyz/for-partners/puzzle-mode.md).
# Puzzle Mode
***
A token listing embeds your token's logo directly inside QR puzzles. Players see it on every solve — not as a separate advertisement, but as part of the puzzle itself.
{% hint style="info" %}
To apply, use the "+ TOKEN / Apply For Listing" option on the Scan Mode page, or the "Prizes / List Your Token" option on the Puzzle Mode page.
{% endhint %}
#### **What's included**
Your token logo appears within the QR image across all puzzle difficulties.
Your token gets a dedicated entry on the Prizes page with a live counter tracking puzzle activity for that token.
### **Puzzle packs**
Visibility in Puzzle Mode is powered by puzzle packs. Tier 1 tokens can hold two pack types:
| Pack type | Description |
| ------------- | ------------------------------------------------------------- |
| FREE\_LISTING | Included with every token listing — one free pack per account |
| PAID\_GENERAL | Additional packs purchased for extended visibility |
Packs are consumed one at a time in FIFO order — the next pack starts only when the current one is finished.
If a Scan Mode campaign becomes active on your token, general packs pause automatically and resume once the campaign ends.
### **What players see**
Players solving puzzles don't select which token appears — the pool rotates. The token logo is visible within the puzzle itself, and all listed tokens with their current activity are shown on the Prizes page.
#### **Partner Space**
When a partner creates a puzzle, a Partner Space becomes available. This is a dedicated dashboard where the partner can monitor their puzzle's activity and access all related information.
#### **What is not included**
A token listing does not include a Scan Mode campaign, the hidden QR mechanic, or a USDC prize pool. Those features are part of Scan Mode.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.qrbase.xyz/for-partners/puzzle-mode.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.