Independent resource · Not affiliated with, endorsed by or operated by GS1® · Learn more
    Back to the test suite

    What is GS1 Digital Link?

    GS1 Digital Link turns the product numbers inside a barcode into a web address. One QR code can then serve the till at checkout, the shopper's phone and the supply chain, all from the same data.

    Anatomy of a Digital Link URI

    A Digital Link is an ordinary HTTPS address built from GS1 identifiers in a fixed order:

    https://id.gs1.org/01/09506000164908/10/ABC123/21/12345?17=271231
    └──── domain ────┘└─ GTIN ─────────┘└ batch ┘└ serial ┘└ expiry ┘

    The domain can be any web domain the brand controls — id.gs1.org is GS1's global resolver, but a brand can use its own. The path holds the primary identifier and its qualifiers; extra data attributes such as expiry dates go in the query string.

    Application Identifiers (AIs)

    Each number in the path is introduced by its Application Identifier, the same codes used in GS1-128 and DataMatrix barcodes.

    AINameRole
    01GTINGlobal Trade Item Number — the product identifier (primary key)
    10Batch / lotQualifier: the production batch
    21Serial numberQualifier: one individual item
    22Consumer product variantQualifier: a variant of the GTIN
    17Expiry dateData attribute, passed as a query parameter (e.g. ?17=271231)
    414GLNGlobal Location Number — identifies a location
    00SSCCSerial Shipping Container Code — identifies a logistics unit

    Resolvers: where the link actually goes

    A resolver is the web service behind the domain. When someone opens a Digital Link it looks up the identifier and usually redirects (HTTP 307) to the brand's chosen default page.

    Callers can ask for something specific with ?linkType=, for example ?linkType=gs1:nutritionalInfo. If a batch or serial isn't known, a conformant resolver "walks up the tree" to the GTIN-level answer instead of failing.

    Asking for ?linkType=linkset (or sending Accept: application/linkset+json) returns the full list of links as JSON. Resolvers should also advertise that linkset in an HTTP Link header.

    Common link types

    Link types come from the GS1 Web Vocabulary. Every resolver must have exactly one gs1:defaultLink; the rest are optional.

    gs1:pip
    Product information page
    gs1:certificationInfo
    Certifications held by the product
    gs1:nutritionalInfo
    Nutrition facts
    gs1:recipeInfo
    Recipes using the product
    gs1:instructions
    Instructions for use
    gs1:recallStatus
    Whether the item is under recall
    gs1:sustainabilityInfo
    Environmental and sustainability details
    gs1:masterData
    Structured product master data

    Why it matters: QR codes at the till

    GS1's "Sunrise 2027" programme aims for retail checkouts to read 2D barcodes such as QR codes and DataMatrix by the end of 2027. A QR code carrying a Digital Link can be scanned at the till for the GTIN and by a shopper's phone for product information — replacing several codes on pack with one.

    What this test suite checks

    The test suite on the home page sends real requests to your resolver and compares the answers against the GS1-Conformant resolver standard: valid URI syntax, HTTPS, CORS, correct redirects, a single default link, linkset format, Link headers and walk-up behaviour. Every link type in your linkset is tested individually.

    Test a resolver now →

    Next: GS1 link types explained · Common resolver errors and fixes

    Official sources: GS1 Digital Link standard · GS1-Conformant resolver standard · GS1 Web Vocabulary