GS1 Digital Link guide

GS1 Digital Link: One Web Address for Every Product

GS1 Digital Link turns GS1 identifiers such as the GTIN into a structured web address. The same code can be scanned at checkout, in the warehouse, and by shoppers with a phone.

Générateur GS1 et Passeport Produit Numérique
Générez des codes QR GS1 Digital Link, DataMatrix 2D, codes-barres 1D ou calculez des clés de contrôle.
Loading QR code generator...

How it is built

Anatomy of a GS1 Digital Link URI

https://gs1.qrs.ly/01/09506000134352/10/ABC123/21/12345?17=271231

  • https://gs1.qrs.ly is the resolver domain chosen by the brand.
  • /01/09506000134352 is the GTIN, the primary key.
  • /10/ABC123 and /21/12345 are key qualifiers for batch and serial number.
  • ?17=271231 carries attributes such as the expiry date.

Resolvers

What a GS1 Resolver Does

A resolver reads the identifiers in the URI and connects the product to online resources. It redirects to a default page, or to a specific link type such as instructions or safety data when an app asks for it. It can also return the full list of links as a machine-readable linkset.

Implementation details

QRStuff Resolver Conformance

The QRStuff resolver at https://gs1.qrs.ly implements the GS1-Conformant Resolver Standard version 1.2.0.

  • Resolver description file: published at https://gs1.qrs.ly/.well-known/gs1resolver.
  • Supported primary key: GTIN, AI 01, with its key qualifiers.
  • Default redirect: HTTP 307 to the default link, passing on the request query string.
  • Link types: linkType requests redirect to the matching link or return 404 when it is not available.
  • Linksets: returned for linkType=linkset, linkType=all, or Accept: application/linkset+json, with a JSON-LD context Link header.
  • Errors: malformed GS1 Digital Link URIs return 400. Unknown products return 404.
  • Compression: EPC binary encoded URIs are decompressed before resolution.
  • CORS: cross-origin requests are allowed for GET, HEAD, and OPTIONS.

Extension: the qrcode query parameter binds a scan to a QRStuff QR code record. The resolver consumes it and does not forward it to destinations.

QRStuff runs the public GS1 resolver conformance tests against gs1.qrs.ly and fixes any failures before updating this page. QRStuff does not claim to be a certified resolver.

GS1 Digital Link FAQs

Create your first GS1 Digital Link

Encode your GTIN and link it to product information in minutes.

Open the GS1 Digital Link Generator