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.
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.lyis the resolver domain chosen by the brand./01/09506000134352is the GTIN, the primary key./10/ABC123and/21/12345are key qualifiers for batch and serial number.?17=271231carries 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:
linkTyperequests redirect to the matching link or return 404 when it is not available. - Linksets: returned for
linkType=linkset,linkType=all, orAccept: 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.