{{ summaryHeading }}
{{ summaryFigure }}
{{ summaryLine }}
{{ readinessLabel }} {{ activeSheet.label }} {{ pageCount }} pages ECC {{ selectedEcc }} Start slot {{ startSlotDisplay }} {{ warningCount }} notes
QR label sheet inputs
Each valid row becomes one QR label. CSV and TXT loading stays local in the browser.
Drop CSV or TXT onto the textarea.
Name the batch or job so exports stay recognizable.
Choose the label stock shape before printing at actual size / 100%.
Number of label cells to leave blank before the first generated QR.
used
Choose how much readable text to print with each symbol.
Controls the QR and text arrangement inside each label cell.
Use Q for balanced printed labels; use H when labels may scuff or wrinkle.
Turn off when printing on pre-cut stock where borders are not needed.
{{ cutGuides ? 'On' : 'Off' }}
Fine-tune top, right, bottom, and left margins for printer alignment.
top right
bottom left
Calibrate gap values if the sheet preview drifts across columns or rows.
in x in y
Blank border around each QR symbol, measured in modules.
modules
{{ qrScale }}%
Increase for QR-only asset tags; reduce when label text needs more room.
{{ fontScale }}%
Lower values help long labels fit on address-label stock.
Module color for every QR symbol.
Background color for the QR symbol area and HTML export.
Controls whether the first CSV row is interpreted as headings.
Use Warn for audit labels; Ignore only when intentional duplicates are normal.
used
# Page Slot Label Payload Type Status Copy
{{ row.number }} {{ row.page }} {{ row.slot }} {{ row.label }} {{ row.payload }} {{ row.type }} {{ row.status }}
Check Status Detail Copy
{{ row.check }} {{ row.status }} {{ row.detail }}
Line Status Detail Copy
{{ row.line }} {{ row.status }} {{ row.detail }}

          
Customize
Advanced
:

Introduction

QR label sheets turn a list of destinations, asset IDs, contact actions, or short notes into scannable labels that can be printed in a fixed grid. The work is less about making one code and more about keeping many codes aligned, readable, and traceable after they leave the screen.

Rows becoming a printable QR label grid with fit, quiet-zone, and contrast checks.

Batch labels are common in inventory rooms, event desks, return bins, guest Wi-Fi cards, lab samples, file boxes, and service counters. A person usually needs two kinds of trust before printing: the payload must decode to the intended action, and the label cell must leave enough space for the QR symbol, readable text, margins, and printer drift.

Small labels create the main tradeoff. Long URLs, vCards, event records, and Wi-Fi payloads consume more bytes than a short asset code. Higher error correction can help a worn or scuffed label survive, yet it also leaves less room for the same payload at the same printed size. A sheet that looks organized can still scan poorly if the QR modules become tiny, the quiet zone is crowded, or the foreground and background colors sit too close together.

A printed QR label is not a proof that the destination is current or safe. It is a compact instruction for a scanner. The responsible finish is a real print at actual size, scanned with the kind of phone or reader that will be used in the field.

Technical Details:

QR symbols are square grids made from modules. Version 1 starts at 21 by 21 modules, and each higher version adds four modules per side until version 40. Payload length and error correction level decide how large the symbol must become. When the printed label cell stays the same size, a larger version means smaller modules and a more demanding scan.

The label sheet problem adds paper geometry to QR geometry. The sheet must fit the selected paper, margins, columns, rows, and gaps before any QR code can be placed reliably. A first-page start position also matters because skipped cells consume sheet slots even though they do not print new codes.

modules per side = 21+4(V-1) used sheet width = Mleft+Mright+CW+(C-1)Gx used sheet height = Mtop+Mbottom+RH+(R-1)Gy

In the sheet formulas, C and R are columns and rows, W and H are one label cell's width and height, and Gx and Gy are the horizontal and vertical gaps. The layout passes only when the used width and height stay within the chosen paper size.

Built-in QR label sheet presets and their geometry
Sheet preset Paper Grid Label cell Typical use
Avery 5160 / 8160 address US Letter 3 columns x 10 rows 2.625 in x 1 in Small asset IDs, return bins, short links, and desk labels.
Avery 5163 / 8163 shipping US Letter 2 columns x 5 rows 4 in x 2 in Larger labels with notes, payload text, or more scan distance.
Letter square asset labels US Letter 4 columns x 5 rows 1.5 in x 1.5 in Square tags where the code is the main visual element.
A4 3 x 8 labels A4 3 columns x 8 rows 2.3 in x 1.25 in A4 office stock with moderate text beside each code.
Custom label sheet US Letter or A4 1 to 8 columns x 1 to 14 rows 0.25 in to 8 in wide, 0.25 in to 10 in tall Nonstandard stock after measuring one label cell and the sheet margins.

Payload checks use UTF-8 byte length, the selected error correction level, and QR version capacity estimates for byte mode. The row is blocked when the estimate would exceed version 40. It moves to Review when byte usage reaches 74% of the estimated capacity and Dense when it reaches 90%.

QR label sheet validation and readiness checks
Check Pass or warning rule Why it matters
Payload rows Missing until at least one valid QR payload is parsed. No printable code exists without a payload value.
Sheet fit Blocked when calculated width or height exceeds the selected paper. Oversized grids drift off the label stock before printing begins.
First slot Review when start position skips one or more first-page cells. Partly used sheets are valid, but the first printed label moves to a later slot.
Quiet zone OK at 4 or more modules, Review below 4 modules. Scanners need clear blank space around the symbol to find its edges.
QR print size OK at an estimated side length of 0.6 in or larger. Very small symbols need cleaner printers and closer scanning.
Contrast OK at 4.5:1 or higher, Review at 3:1 to 4.49:1, Blocked below 3:1. Low contrast can hide modules from cameras and handheld readers.
Payload density Blocked when any payload exceeds the estimated QR byte capacity. Long structured payloads can force a symbol beyond the allowed version range.
Duplicate payloads Review when duplicate warnings are enabled and the same payload appears more than once. Repeated destinations may be intentional, but they are easy to miss in a long batch.
QR renderer Ready after the browser QR renderer loads, Missing if it is unavailable. The preview and standalone HTML need rendered symbols, not just parsed rows.

Error correction levels L, M, Q, and H trade capacity for recovery from damage. DENSO WAVE describes the levels as roughly 7%, 15%, 25%, and 30% restoration capability for total codewords. Level Q is a sensible print-label default here because it leaves more recovery room than M without jumping immediately to the densest H setting.

Everyday Use & Decision Guide:

Start with the real label stock. If you are using Avery 5160 / 8160 address labels, keep that preset and print at actual size or 100%. For unknown stock, choose Custom only after measuring one label cell, the paper size, margins, and gaps. Guessing the grid usually wastes a sheet because a small margin error grows across columns and rows.

Paste rows as label,payload,note when you want readable text next to each code. A single value line still works, but it becomes an automatic label with that value as the payload. Header auto-detection can skip a first row such as label,payload,note; switch Header row to None when the first row is real label content.

  • Use Label and note for asset labels where humans need a short location or purpose cue.
  • Use QR only when the label is small and the scan target is already tracked somewhere else.
  • Set Start position to the count of already-used cells on a partly used first sheet.
  • Keep Quiet zone at 4 modules unless a real print test proves the smaller border still scans.
  • Leave duplicate payloads on Warn for audit labels, inventory labels, and any batch where two stickers should not point to the same destination.

Review the summary before printing. Print ready means the current checks passed. Review print means the sheet can still be usable, but at least one detail deserves attention, such as a skipped first slot, dense payload, duplicate destination, or a quiet zone below four modules. Print blocked means a hard issue exists, such as no valid payload rows, an oversized custom grid, very low contrast, or a payload beyond the estimated QR capacity.

The result does not prove that every destination is correct. Open the Label Layout tab to compare page and slot positions, use Print Check to clear blocking checks, and scan a printed test sheet before running a large batch.

Step-by-Step Guide:

Build the sheet from rows first, then tune the print layout and scan checks.

  1. Paste label rows into Label rows, or use Browse CSV/TXT to load a local text file. The summary should move from Load labels to a label count once valid payloads are found.
  2. Enter a Sheet title that will make downloaded HTML, CSV, DOCX, and JSON files recognizable. The title is not printed inside cells unless the same words appear in the pasted rows.
  3. Choose Sheet preset. Use the Avery, Letter square, or A4 presets when they match your stock. Use Custom paper, Custom grid, and Custom label size only when you have measured the sheet.
  4. Set Start position before printing on a partly used sheet. The summary badge changes to the first slot number, and Print Check marks First slot as Review when one or more cells are skipped.
  5. Choose Label content, Text position, Error correction, and Cut guides. Auto text placement puts text beside wide labels and below squarer labels.
  6. Open Advanced if print alignment or scan quality needs tuning. Adjust margins, label gaps, quiet zone, QR scale, text size, foreground color, background color, header handling, and duplicate handling there.
  7. Check Print Check. Fix Blocked rows before printing, and resolve Review rows when they affect the job. If a row appears as Missing in Parse Log, add a payload cell or remove the empty row.
  8. Use Printable Sheet to print or download standalone HTML after the preview has rendered. For records, export Label Layout, Print Check, Parse Log, or JSON.

Interpreting Results:

The summary status is the fastest read. Print ready means the parsed rows, sheet fit, quiet zone, estimated QR size, contrast, payload capacity, duplicate rule, and renderer check are all acceptable. Review print is a caution state, not a failure state. Print blocked should stop printing until the blocked check is corrected.

  • Label Layout is the slot map. Use it to confirm that the right label lands on the right page and slot.
  • Print Check is the reliability checklist. Sheet fit, contrast, payload density, and renderer status carry the most direct blocking risk.
  • Parse Log explains skipped headers, missing payloads, duplicate warnings, and truncation above 300 valid rows.
  • JSON is the audit snapshot, including sheet settings, QR settings, label records, print checks, and parse log entries.

Do not treat an OK check as a substitute for scanning. Printer scaling, glossy stock, wrinkles, curved surfaces, and old phone cameras can still affect printed QR labels. Scan the final paper output at normal use distance before applying the labels.

Worked Examples:

Inventory shelf labels

A facilities team pastes four rows such as Asset 042,https://example.com/assets/042,Rack A and keeps Avery 5160 / 8160 address as the sheet preset. With Label and note, ECC Q, a 4-module quiet zone, dark foreground, and white background, Label Layout places the rows on page 1 slots 1 through 4. Print Check reports Quiet zone OK, QR print size OK at about 0.82 in, Contrast OK, and Payload density OK, so the summary can reach Print ready once the renderer is ready.

Partly used first sheet

A batch of 40 desk labels is printed on Avery 5160 stock after eight labels have already been used on the first sheet. Setting Start position to 8 moves the first new label to slot 9. The 30-slot sheet now needs two pages because the skipped cells count against first-page capacity. Print Check marks First slot as Review, which is expected rather than a defect.

Custom grid that cannot fit

A user chooses Custom label sheet on US Letter paper, sets 8 columns and 14 rows, and enters 2 in x 2 in label cells. The calculated sheet width is far wider than 8.5 in, so Sheet fit becomes Blocked and the summary becomes Print blocked. Reducing the column count or using larger paper is required before the printable sheet can be trusted.

Missing payload row

A CSV line such as Rack A, has a label but no payload. Parse Log shows Missing with the detail No QR payload found on this row. Adding a URL, asset code, Wi-Fi payload, email action, or other payload in the second cell clears the row-level error.

FAQ:

What row format should I paste?

Use label,payload,note for the clearest layout. With a header row such as label,payload,note, Header row set to Auto skips that header. A one-cell row is accepted as a payload and receives an automatic label.

Why does Print Check say blocked?

Blocked appears when a hard requirement fails, such as no valid payload rows, custom sheet geometry that exceeds the paper, contrast below 3:1, or a payload that exceeds the estimated QR byte capacity for the selected error correction level.

Why did my row show Missing in Parse Log?

Missing means the parser did not find a QR payload on that non-empty line. Add a value in the payload position, or use a single-cell row when the value itself is the payload.

Can I use colored QR labels?

Yes, but keep strong foreground and background separation. The Contrast check reports OK at 4.5:1 or higher, Review from 3:1 to 4.49:1, and Blocked below 3:1. A printed scan test still matters because paper, ink, and lighting change readability.

What happens above 300 labels?

The parser includes only the first 300 valid label rows for browser rendering and adds a Review entry explaining that the list was truncated. Split larger jobs into smaller sheets before printing.

Does the CSV or TXT file get uploaded?

CSV and TXT loading stays in the browser, and QR symbols and exports are built locally after the QR renderer loads. The page does load its QR rendering script from a third-party CDN, so review confidential batches under your normal data-handling rules.

Glossary:

Payload
The text encoded in one QR label, such as a URL, asset code, Wi-Fi string, email action, or plain note.
Module
One small square in the QR symbol grid.
Quiet zone
The blank border around a QR symbol. Four modules on every side is the standard target used by the check.
Error correction
The QR recovery setting, shown as L, M, Q, or H, that trades payload capacity for tolerance of damage.
Sheet preset
A stored paper and grid layout that sets label size, rows, columns, margins, and gaps.
Start position
The number of first-page cells skipped before the first new QR label is placed.

References: