Global Retailer Schema

The Label Insight Global Retailer Schema is the default schema for all Attribute data delivered for international retailers (Non-US) via the Products API or to Label Insight's hosted SFTP.

Data Types

Global Retailer Schema along with the associated data type for each field.

{
  "upc": "String",
  "brand": "String",
  "productTitle": "String",
  "gtinFormats": {
    "upc12NoCheckDigit": "String",
    "gtin14": "String",
    "gtin12": "String"
  },
  "attributes": [
    {
      "name": "String"
    },
    {
      "name": "String"
    },
    {
      "name": "String"
    }
  ],
  "lastUpdatedTimestamp": "IsoTimestamp"
}
{
  "upc": "894936000544",
  "brand": "TUTTI",
  "productTitle": "CHOCOLATE ALMOND & CINNAMON gourmet BISCOTTI",
  "gtinFormats": {
    "upc12NoCheckDigit": "089493600054",
    "gtin14": "00894936000544",
    "gtin12": "894936000544"
  },
  "attributes": [
    {
      "name": "Kosher"
    },
    {
      "name": "Gluten-Free"
    },
    {
      "name": "Made In Canada Stated"
    }
  ],
  "lastUpdatedTimestamp": "2025-02-20T22:22:33.705608Z"
}

Field Documentation

Field Name

Description

Example

upc

This is the verbatim on package barcode captured for this given product. This field is NOT normalized to adhere to a certain GS1 Code and is strictly transcribed from the packaging image.

012345678900

brand

The brand of the product as listed on package.

Best Brand

productTitle

This is the identity of the product or the main product description associated with the product label. This field consists of the observed statement of identity, including Flavor when applicable.

Strawberry Whole Milk Yogurt

gtinFormats

upc12NoCheckDigit

12 digit with no rear check digit

001234567890

gtin12

12-digit with rear check digit

012345678900

gtin14

14-digit product identifier which is comprised of three components:
(1) One digit representing the Indicator Digit to indicate packaging level;
(2) Twelve digits containing the GS1 US-Issued GS1 Company Prefix and the Item Reference which is designated internally by the brand/company;
(3) One digit representing the check digit

00123456789000

attributes

name

The name of the attribute licensed, only appears when the product qualifies for the associated attribute.

Organic

lastUpdatedTimestamp

The last date which the product data licensed by the Customer in their configuration has experienced an update or change. Please note, Label Insight's update every product weekly and this is not a field that can be leveraged to detect data deltas.

2021-02-27T04:51:26.948Z