GS1 Linkset JSON

book reader icon
1 Minute
facebook logo gray
linkedin logo gray
mail logo gray

What is a GS1 Linkset?

At its core, a GS1 Linkset is a machine-readable file, typically in RDF (Resource Description Framework) or JSON-LD format, that provides semantic relationships (links) between:
  • A GS1 Digital Link URI (e.g., a URL that resolves from a barcode or QR code)

  • Other useful resources or documents associated with the product (like a product page, image, instruction manual, safety data sheet, etc.)

It describes how these resources relate to the product identified by a GS1 identifier (such as a GTIN, GLN, etc.).

Why is it useful?

  • Semantic interoperability across different systems (e.g., supply chain, retail, and logistics platforms)

  • Easy retrieval of contextual data about a product, location, asset, etc.

  • Use of standardized vocabularies like schema.org and GS1 Web Vocabulary

  • Dynamic linking — different users (e.g., consumers vs retailers) can see different linked content depending on their needs or context (language, location, role, etc.)

  • Structure of a GS1 Linkset

    {
      "@context": [
        "https://www.w3.org/ns/json-ld#context",
        "https://ref.gs1.org/standards/gs1-link-types"
      ],
      "anchor": "https://id.gs1.org/01/09506000134352",
      "links": [
        {
          "rel": "gs1:pip",
          "href": "https://example.com/pip/09506000134352"
        },
        {
          "rel": "gs1:certification",
          "href": "https://example.com/certificates/09506000134352"
        },
        {
          "rel": "gs1:productDescription",
          "href": "https://example.com/products/09506000134352/description"
        },
        {
          "rel": "gs1:allergens",
          "href": "https://example.com/products/09506000134352/allergens"
        },
        {
          "rel": "gs1:nutritionalInfo",
          "href": "https://example.com/products/09506000134352/nutrition"
        },
        {
          "rel": "gs1:usageInstructions",
          "href": "https://example.com/products/09506000134352/usage"
        },
        {
          "rel": "gs1:consumerInformation",
          "href": "https://example.com/products/09506000134352"
        }
      ]
    }

    Key Elements Explained

    FieldMeaning
    @contextPoints to JSON-LD context, including GS1-specific link types.
    anchorThe identifier for the resource (e.g. the GTIN URI https://id.gs1.org/01/GTIN).
    linksAn array of link objects that describe different GS1 Digital Link relations.

    Each rel in the links array corresponds to a GS1 Link Type

    How to test if Linkset is available?

    To test if a Digital Link has a Link Set assigned you can enter the URI of the the digital link here https://ref.gs1.org/test-suites/resolver/

    How to access the Linkset?

    Option 1: Content Negotiation (Preferred)

    The GS1 Digital Link URI itself (e.g. with GTIN) returns different representations depending on Accept headers.
    GET https://id.gs1.org/01/09506000134352
    Accept: application/linkset+json

    Option 2: .linkset.json Suffix

    Alternatively, the client can directly request the linkset using the suffix linkset.json

    https://id.gs1.org/01/09506000134352.linkset.json

    Option 3: linkType Parameter

    Alternatively, the client can directly request the linkset using the linkType parameter set to all or linkset.

    https://id.gs1.org/01/09506000134352?linkType=linkset
    https://id.gs1.org/01/09506000134352?linkType=all
    Last update 6 days ago