What is a text QR code?
A text QR code stores any plain-text string directly inside the QR pattern. When scanned, the user's device decodes the text and displays it — no internet connection required. It is the simplest and most universal QR type, and every standards-compliant scanner (which is essentially every modern smartphone camera) can read it.
Because text QRs don't trigger any action automatically — no browser opens, no app launches — they are also the safest type for sensitive information. The scanner sees the decoded text and decides what to do with it, which means there is no risk of accidentally triggering a malicious URL or a hidden command.
How the QR specification handles text
The QR standard supports four data modes: numeric, alphanumeric, byte (UTF-8), and Kanji. FixedQRCode automatically selects the most efficient mode for your input. Short numeric strings produce the smallest, sparsest codes; full Unicode (emoji, accented characters, non-Latin scripts) uses byte mode, which is less dense but supports any character. A 50-character ASCII string typically fits in version 4 of the QR spec (33×33 modules) — small enough to print on a label.
Static vs dynamic text QR codes
Many third-party services "wrap" your text in a redirect so they can track scans. The moment that service goes away, the QR breaks — and even while it works, scanning means opening a browser, hitting a redirect, and being shown a hosted page. FixedQRCode stores the text directly inside the QR pattern, so there is nothing to host and nothing to expire. The QR is fully self-contained, works offline, and the scanner shows the raw text immediately.
Common use cases
- Coupon and discount codes printed on flyers, postcards, and direct-mail pieces — the user just copies the code.
- Serial numbers or part IDs on equipment labels for fast inventory lookups and tech support.
- Quotes, poems, or messages hidden inside greeting cards, wedding favors, or memorial plaques.
- Asset tracking in warehouses, schools, hospitals, and field operations — the code is the asset's identity.
- Game clues for escape rooms, treasure hunts, and educational scavenger hunts.
- Crypto wallet addresses where the text is the address itself.
- Permanent labels on tools, instruments, and equipment that needs to be identifiable for decades.
- Library and archive identifiers linking physical objects to catalog entries.
Privacy advantages
FixedQRCode does not store the text you encode. The rendering server reads your input long enough to produce the image, streams it back, and forgets it. There is no account, no history, no analytics. This makes static text QRs suitable even for sensitive identifiers like internal SKUs, asset tags, or short notes you don't want archived anywhere.
Printing recommendations
Use the SVG download for print so the code stays crisp at any size — SVG is resolution-independent and accepted by every layout tool. The more text you encode, the denser the QR pattern, so for long strings print at a larger size (at least 3 cm / 1.2 in across) and keep good contrast. As a guide, every additional 50 characters of byte-mode text bumps the QR version up by one or two, increasing the module grid. For codes printed at 5 cm or larger, you can encode several hundred characters and still scan reliably.
For laser-printed labels on matte stock, foreground color #0F172A on white gives the best reliability. On adhesive vinyl or fabric, consider increasing the size by 25% to compensate for ink bleeding into the substrate. Avoid printing on transparent or reflective materials without a solid backing — scanners need a stable contrast.
Business use cases
Manufacturing plants, museums, hotels, hospitals, and retail stores all benefit from static text QRs because they never depend on a third-party server. A QR encoded with "ASSET-2026-00417" on a piece of medical equipment will decode to that exact string in 20 years, regardless of what software ecosystem exists then. That's the kind of durability that compliance and asset-management teams need.
Combining text QRs with other media
Text QRs work well as part of multi-modal exhibits and learning materials. Pair a text QR with a printed image, an audio clip URL, and a tactile element to support different learning styles. In retail, a text QR carrying a promo code right next to the printed code lets shoppers redeem it digitally without typing — copy-paste from their phone into a checkout flow. The QR doesn't replace human-readable text, it complements it.
Troubleshooting tips
- If a long string fails to scan, shorten the text or increase the printed size.
- Avoid extreme color combinations — high contrast (dark on light) scans most reliably.
- Some older scanners limit text length to ~300 characters; keep important content within that limit.
- Special characters like newline, tab, and emoji are supported but may render differently per scanner. Test on iOS and Android before printing.
- If the decoded text shows mojibake (garbled characters), the scanner is interpreting bytes as the wrong encoding — stick to UTF-8.
- When encoding URLs as "text", omit the
http(s)://prefix only if you don't want the scanner to auto-open them.