DLCode Resolver Overview

One code, three readers and a link you control

A GS1 Digital Link QR code holds a web address with your Global Trade Item Number (GTIN) in the path. Scanners read the number, and phones open the page. Every DLCode code points to https://dlcode.org/01/{GTIN-14}, with an optional /10/{lot}, and the resolver at dlcode.org decides where each scan goes.

DLCode is more than just a QR code file. It’s the resolver behind the code, self-assessed against the GS1-Conformant Resolver standard.2

Give each scan the right destination.

  1. Point-of-sale softwareReads the GTIN from the URL path without contacting a server.
  2. Phone cameraOpens the URL. The resolver sends the scan to your destination, your country page, or your recall notice.
  3. Software and appsRequest the linkset and get every link for the product in one standard JSON response.

Specifications

  • Description file at /.well-known/gs1resolver
  • Linkset JSON (RFC 9264) through ?linkType=linkset or Accept: application/linkset+json
  • Link header on responses that points to the linkset
  • GS1 Web Vocabulary link types, for example ?linkType=gs1:pip
  • HTTP 307 redirects with Cache-Control: no-store
  • HTTP 400 for invalid URIs
  • Country routing through ?context=CA or the country of the request
  • Primary key supported: GTIN (AI 01)

DLCode is the ideal solution for:

  • Brands that want to change where a scan goes without a reprint
  • Food brands that need lot-level recall notices
  • Products sold in more than one country

Need your own domain in the code?

Codes use dlcode.org by default. To put your own domain in the code, contact hello@dlcode.org before you print.

Contact us

That’s one printed code for the register and the phone.

Infrastructure

Reliable infrastructure for printed codes

DLCode runs on Cloudflare’s global network. Each fact below links to where you can check it, where a public source exists.

348 cities

Cloudflare’s network answers each scan from a nearby location.

See the network
TLS 1.3

Every scan is encrypted, and every response sends HSTS.

0 cookies

Scan pages set no cookies and load no ad trackers.

Open a scan page
7 days

Point-in-time recovery for product data, to any minute.

How recovery works
Prepaid to 2030

Hosting for each pack is paid through December 31, 2030.

See pricing
Wyoming LLC

Operated by Coastal Sunbeam LLC, a Wyoming limited liability company.

Read the terms
Protected by Cloudflare
  • TLS certificates managed by Cloudflare
  • Product data stored in North America
  • HTTPS only, with HSTS on every response

Ready to print your first code?

Start free with 3 products, or get in touch at hello@dlcode.org.

  1. Available on paid packs.
  2. Self-assessed against the GS1-Conformant Resolver standard. Not certified by GS1.