> 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

Get your token logo inside QRbase puzzles.

***

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.

<table data-card-size="large" data-view="cards" data-full-width="true"><thead><tr><th data-hidden></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td></td><td><a href="https://4070661630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtwEgj44qpK60ZhpgDyf0%2Fuploads%2F7Xb95Eo1lJFNRVUckWlr%2FScreenshot%202026-04-15%20120626.png?alt=media&amp;token=af333677-20dc-4177-9629-07a6c4ec52cd">Screenshot 2026-04-15 120626.png</a></td></tr></tbody></table>

#### **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.