The QR label of the TigerTag ecosystemTigerQR

The chip's NFC UID in hex, 14 characters. The twin chip's UID opens the same spool.

The TigerData id without its TigerData_ prefix: 10 or 17 digits. The long form TigerData_6130922252 opens too.

The id_product in decimal, always 10 digits with leading zeros (p/0010303748). Labels printed with 8 hex characters (p/9f5e0644) still open.

One byte segment, ECC M

The whole link, lowercase, in one byte-mode segment with error correction level M (15 %): labels get scratched and folded. A lowercase scheme cannot use the alphanumeric mode, and splitting the link into segments saves nothing.

29 × 29 modules

Every spool and product link fits a version 3 code, 29 × 29 modules. The label's white margins are its quiet zone.

Lowercase, always

Tested 2026-11-07: the iPhone camera opens a link in either case, but the Samsung camera (Galaxy S24) shows an uppercase HTTPS:// link as plain text and opens only a lowercase one.

Whole printer dots per module

Each module covers a whole number of dots: the nearest one that fills the QR box, rounded up when that stays within 6 % of the box, down otherwise. A PNG is drawn at exactly the label's size in dots, never resampled.

Tenths of a millimetre

One SVG per label, sized in millimetres, laid out in tenths of a millimetre and scaled to printer dots at 203 or 300 dpi.

Texts keep clear

Texts never run over the QR or the pill: a long text shrinks first, then is narrowed. Tiger Studio and tigersystem.io draw the same SVG, byte for byte.

Reading a link

The order a reader follows, as splitLangPrefix and parseQrPath in src/parse.ts do it.

1. 1Drop a language prefix

   A shared link's leading /<lang>/, in any case.

2. 2Normalise the path

   Percent-decode, drop leading and trailing /; an empty path is the root.

3. 3Take the ending

   One .json or .ttag, any case; else a page.

4. 4Product, older form

   p/ + 8 hex: the hex value (8 digits: the decimal reading is tried when the hex one is not in the catalogue).

5. 5Product, printed form

   p/ + 1 to 10 digits: the decimal value; above 4294967295 is unknown.

6. 6Spool

   10 or 17 digits, then 14 hex, then 13 hex starting with 4 (a leading 0 put back), then tigerdata_ / tigerdata- + digits.

7. 7Anything else

   A label from a newer version: say "update the app" instead of failing.

What each shape names

A chip UID has 14 characters and a TigerData id 10 or 17 digits, so an all-digit UID is never read as a TigerData id. A product link always starts with p/, so it never collides with a spool.

TypeScript: read and build

import { parseQrPath, splitLangPrefix } from "./src/parse";
import { productLink, spoolLink, qrLinkFrom } from "./src/links";

const { lang, path } = splitLangPrefix("/fr/p/2673739332");
parseQrPath(path);
// { kind: "product", idProduct: 2673739332,
//   hex: "9f5e0644", format: "page" }

productLink(10303748);
// "https://qr.tigertag.io/p/0010303748"
spoolLink("TigerData_6130922252");
// "https://qr.tigertag.io/6130922252"
qrLinkFrom("chip", "1D:33:DB:DA:0D:10:80");
// { kind: "chip", link: "https://qr.tigertag.io/1d33dbda0d1080" }

Test against the vectors

test-vectors/links.json lists every link shape with the exact answer: read (a path and what it names), lang (the language prefix), build (an id typed for a kind and the printed link), spoolLink, productLink and sharedLink.

git clone https://github.com/TigerTag-Project/TigerQR-Label
cd TigerQR-Label
node tools/check.mjs   # Node 22.13 or later

A reader in another language passes when it gives every expect of the read and lang sections.