How to Create a Text QR Code That Works Offline

CreationCreate by Type

Published

Share
Illustration for How to Create a Text QR Code That Works Offline

Overview

A text QR code can work offline when the message is stored directly in the symbol and the reader can decode and display it locally. Google’s ML Kit documentation confirms that its barcode scanning runs on the device without a network connection. That establishes the technical possibility—not a guarantee about every camera or scanner app. [1]

The practical recipe is simple: choose plain-text output, encode the actual message rather than a hosted page, download the code, and test it with all network connections off.

What “works offline” actually means

Separate these three tasks:

  • Creating the code: This tutorial does not assume that a generator website works without internet. Create and download the image before you need it.
  • Reading the message: Use a reader that decodes the QR code and shows its text locally. On-device decoding is supported by implementations such as ML Kit. [1]
  • Acting on the message: Reading an address is different from loading its website. A code that contains a link does not also contain the destination page. This distinction follows from the separation between decoded barcode data and the action an app takes with it. [1]

For example, encode Asset ID: WH-009184 if that is what someone needs to read. Do not substitute a link to an online asset record when offline access to the identifier is the requirement.

How to create an offline text QR code

1. Prepare a short, self-contained message

Write something that makes sense without a website or database lookup. For example:

Asset ID: WH-009184
Location: Warehouse B, Shelf A-14
Reference: Inspection sheet 07

Treat this as an illustrative payload, not a tested QR sample. Use short labels and simple line breaks, and remove unnecessary paragraphs.

There is no universal character count that guarantees a readable code. Capacity depends on the QR version, character type, and error-correction level. More data can require more modules—the small squares making up the symbol. At a fixed printed size, that means smaller modules. [2]

2. Select plain-text output

Use a generator that explicitly supports Text or Plain text. These are generic content-type labels, not verified QRHyper interface instructions.

Your acceptance criterion should be: the decoded payload is the message itself. Reject an output that decodes to a provider’s web address and only displays your note after opening that address. QR scanning software distinguishes decoded data from actions such as opening URLs. [1]

Do not rely on a generator’s “static” label alone. Verify the actual decoded content before printing.

3. Generate and inspect the result

Scan the downloaded image with a reader that exposes the decoded text. Compare it against your original message:

  • Are all lines present?
  • Are identifiers, punctuation, and spaces correct?
  • Is the result your text, rather than a web address?
  • Can you read it without accepting an online search or opening a browser?

If you include accented characters, non-English text, or emoji, add those exact characters to your compatibility test. Encoding support is not universal: Google documents an ECI-mode limitation in ML Kit’s barcode reader. This does not mean all non-English QR codes fail; it means broad compatibility should not be assumed. [1]

4. Preserve the code’s clear border and readable modules

Keep an empty border, called the quiet zone, at least four modules wide on every side. Do not crop it away or place nearby text inside it. DENSO WAVE specifies this margin for QR Code symbols. [3]

As a conservative production choice, use a plain black-on-white design without a logo overlay. Export a sharp image or vector file if the generator offers one, and inspect the final layout rather than only the generator preview.

Do not shrink a dense code simply to fit a label. DENSO WAVE explains that larger modules improve reading stability and that usable module size depends on the printer and reader. There is no single minimum printed size suitable for every deployment. [4]

5. Run an actual offline acceptance test

Use this checklist before distributing the code:

  1. Install and initialize the intended scanner while connected, if needed.
  2. Put the phone in airplane mode, then explicitly turn off Wi-Fi and cellular data.
  3. Close and reopen the scanner.
  4. Scan the saved code displayed on another screen, or scan the final printed label.
  5. Confirm that the complete message appears without a browser, search, sign-in, or network request being required.
  6. Repeat with the devices and readers your audience will actually use.

For print, repeat at the intended distance and under realistic lighting. Google’s Pixel troubleshooting guidance specifically recommends avoiding blur, shadows, and glare and keeping the whole code visible. [5]

Pass condition: the reader displays the exact message with network access disabled. Recognizing the square or showing a search suggestion is not enough.

Will the built-in phone camera show plain text?

Do not promise identical behavior across phones. Apple documents Camera and Code Scanner on iPhone and iPad. Google documents scanning with the Pixel camera. Test plain-text display on the devices you plan to use. [6][5]

Google’s separate Camera from Google documentation explicitly includes viewing text, but says the feature is available only on selected devices. It is not a blanket statement about every Android phone or Pixel camera. [7]

Start with the audience’s built-in scanner. If it does not expose the text, test a reader that explicitly displays decoded plain text offline. Arrange that reader before deploying labels in a disconnected environment.

Practical limits to plan for

  • Changing information: Treat directly encoded text as fixed. If the message changes, generate a replacement code and replace the distributed image or label. This follows from storing the payload in the symbol itself. [2]
  • Privacy: Treat a publicly displayed code like a public label. Do not put passwords, lockbox combinations, or confidential notes in your example payloads.
  • Essential instructions: Keep critical information readable without scanning, too. Use the QR code as a supplement, not the only way to access an urgent instruction.

References

[1] Google for Developers, Barcode scanning — https://developers.google.com/ml-kit/vision/barcode-scanning

[2] DENSO WAVE, Information capacity and versions of the QR Code — https://www.qrcode.com/en/about/version.html

[3] DENSO WAVE, Point for determining the code area — https://www.qrcode.com/en/howto/code.html

[4] DENSO WAVE, Point for setting the module size — https://www.qrcode.com/en/howto/cell.html

[5] Google Pixel Camera Help, Scan QR codes with your Pixel phone — https://support.google.com/pixelcamera/answer/16561572?hl=en

[6] Apple Support, Scan a QR code with your iPhone or iPad — https://support.apple.com/en-us/102680

[7] Camera from Google Help, Scan QR codes on Camera from Google — https://support.google.com/camerafromgoogle/answer/12033278?hl=en

Ready to create your QR code?

Create QR Code