Allocating QR Labels to your account
Before you can print a sticker, you need to allocate codes from the platform pool to your account. Allocated codes are reserved for you — only you can claim them, and only you can print them.
How to allocate
Go to the QR Labels page (/qr/).
If your account is a regular user account on the Personal/Family/Pro plan, codes are pre-allocated based on your plan's quota. Personal: 15 to start. Family: 100. Pro: more, depending on the contract.
If you're an admin (platform_admin role), you'll see an additional Allocate codes form on the QR page. Pick a count (max 500 per request), hit Generate. The codes are generated, allocated to your account, and ready to print immediately.
How many do I need?
Rough rules of thumb:
- One per box you'll have. Boxes are the highest-value place to put a QR.
- One per high-value item (camera, watch, bike, laptop). For insurance.
- A handful of spares for things you'll add later.
For a typical home: 30–60 codes covers a thorough first pass. For a self-storage unit: 20–40 codes.
Don't try to put a QR on every sock. The QR's value is in finding things you wouldn't easily find otherwise.
Buying more
When you hit your quota and need more codes, you can either:
- Upgrade your plan to a tier with a higher cap.
- Buy a one-time top-up (planned feature, not yet shipped).
Until top-ups ship, the upgrade path is the only way to get more codes.
Re-using a code
If you delete a resource that had a code attached, the code goes back to your unclaimed pool. You can attach it to a different resource later. You don't lose the quota slot.
If you generated a sticker, attached it to a box, used it for a year, then sold the box without the sticker, you can:
- Delete the box (or rotate the code — see Rotating a QR Label).
- The code goes back to your pool.
- Print a new label on the same code (or a new one).
- Attach to a different box.
Why is the QR pool centrally managed?
To prevent token collisions across accounts and to let us audit the pool. Random 12-character tokens have a vanishingly small collision probability, but at scale we want to be sure. Centralised generation makes uniqueness trivial.
Codes don't expire
Once a code is allocated to your account, it's yours forever (or until you delete your account). Unclaimed codes can sit in your pool indefinitely.