Attaching a QR Label to a resource

Allocated codes start out unclaimed — they belong to your account but don't point at anything. To turn an unclaimed code into a working sticker, you "claim" it by attaching it to one of your resources (item, box, closet, or location).

Three ways to attach

1. While creating a new resource

When you create an item, box, closet, or location, the create form has a QR Label dropdown showing your unclaimed codes. Pick one (or leave blank for auto-generation if available). Save. The code is now claimed.

This is the most common path.

2. After creating a resource

If you saved a resource without picking a code, open its view page. There's a QR Label panel showing the current state. If no code is attached, you'll see a Generate QR button — click it to auto-allocate one of your unclaimed codes.

3. From the QR Labels page

Open /qr/, click an unclaimed card, and the print page lets you click into the resource picker. Pick a resource. Save. Done.

What "claiming" actually does

A claim is a database update that:

• Sets qr_tokens.pool_status = 'claimed'
• Sets qr_tokens.resource_type and qr_tokens.resource_id
• Sets qr_tokens.claimed_at = NOW()

That's it. The token's URL doesn't change; only what the URL resolves to changes.

One-to-one relationship

Each token attaches to exactly one resource. Each resource can have at most one active token. You can't put two QR stickers on the same box that both resolve to it (well, you can physically, but only one is the "official" one).

If you need a backup sticker on the same box, attach a second token to the same resource via the rotate-and-keep-old flow (advanced, not recommended).

Detaching

If you want to "free" a code from its resource without deleting either, you have to either:

• Delete the resource (the code returns to your unclaimed pool)
• Rotate the code (the resource gets a new token; the old token is revoked, not freed)

There's no current UI for "detach without rotating or deleting". File a feature request if you need it.

What if I print the wrong sticker?

You printed Kitchen 1 but stuck it on the bedroom box. Three options:

• Repaint reality — go edit the box's label to Bedroom 1. The sticker is still right.
• Print a new sticker — generate the right one for the bedroom box, peel off the wrong one.
• Rotate the code — only useful if you also need to revoke the old token (e.g. someone has the old printout and you don't want them to find this box). See Rotating a QR Label.