Skip to main content
The GS1 QR code Closient sends you carries your product’s GTIN as a GS1 Digital Link. Every unit printed with it scans to the same product page. That is enough to replace a UPC, but not enough to recall one run without recalling them all: a scanner can only tell which units are affected if the code says which run each unit came from. This page shows how to put that information in the code, using one template your label software fills in per run, and how big to print it.

What to put in the code

The lot and serial identify which units you made, so they are key qualifiers and go in the path. Dates and the production site describe the units, so they go in the query string after ?. Join more than one with &. The lot and serial each take up to 20 characters of letters, digits and a few punctuation marks. Spaces are not allowed. Most food, beverage and cosmetics products are lot-managed: put the lot and a date in every code, and add a serial only when you genuinely track individual units. Lot-Scoped Recalls explains which identifiers a recall needs and why.

One template, every run

The email Closient sends includes a template like this, with your own resolver host:
Bind your label or packaging software to it once. For each production run it fills in the lot, serial and expiration date, and prints a unique, recall-ready QR code without anyone redrawing artwork. Leave out the parts you don’t track: drop /21/{serial} for lot-managed goods, or swap 17 for 15 if you print a best-before date instead. A filled-in code for one unit looks like this:
Characters outside letters and digits in a lot or serial are percent-encoded in the link (a / becomes %2F). Most label software that supports GS1 Digital Link does this for you.

How big to print it

The PDF in the email shows your QR code at three sizes, each drawn at true size so you can measure it on paper: The finished size depends on how much the link holds: a code carrying a lot, serial and date has more modules than one carrying only the GTIN, so it is larger at the same X-dimension. Always size from the code you will actually print. Each size in the PDF includes the quiet zone, the blank margin a scanner needs around the code; keep it clear of other artwork. Print the PDF at 100% (actual size), never “fit to page”, or the sizes on it are wrong. QR Code Sizing covers the X-dimension in more depth.

What else is in the email

  • The same link as a GS1 DataMatrix, for packs where a square code doesn’t fit. It encodes exactly the same Digital Link.
  • Your linear barcode (EAN-13, UPC-A or ITF-14, whichever your GTIN takes) at 100% magnification. Keep it on the pack while checkouts still scan 1D barcodes.
  • SVG files of each QR code at the recommended size, for your designer.

Checking a code

Scan the code in the email with any phone camera. It should open your product’s page on Closient. A code carrying a lot or serial passes them through to the page, which is what lets a lot-scoped recall reach the people who scan an affected unit; Lot-Scoped Recalls covers how recall status is resolved per lot.