Masterdata — the GS1 Web Vocabulary

Location identifiers assigned and managed by government bodies, trade organisations, and other entities.

Secondary location identifiers from government or trade schemes serve administrative cross-referencing, not consumer information.

Party/organisation identifiers assigned and managed by government bodies, trade organisations, and other entities.

Secondary party identifiers (tax, customs, trade-body numbers) are administrative identifiers for authorities and B2B partners.

The value associated with the Additional Organization Identification Type Value.

This value qualifies the non-public additional organization identifier and shares its administrative audience.

Relates to a set of additional product classification details.

Additional classification codes categorise the product the same way the public GPC classification does.

Additional variants necessary to communicate to the industry to help define the product.

Additional descriptive variants refine the public product description and carry no confidential content beyond it.

Relates to details about any additives that a product may contain.

Additive details mirror ingredient information consumers already read on the label of the products concerned.

The postal address for an organization or place.

The postal address of a registered business party or site is public registry and business-directory information.

Links to after-hours contact information.

After-hours contacts are operational emergency channels for partners and authorities, distinct from the published consumer contact point.

Link to a file containing an audio clip which is relevant to the product.

Product audio clips are published brand media intended for consumer consumption.

Links to details of covert/overt security markings that may be used to check authenticity of a product instance.

Authenticity-checking details only fulfil their purpose if the consumer verifying a product instance can read them.

An award or prize given to the product.

Awards and prizes are promotional facts the brand itself publicises on pack and product page.

A fixed physical location where a mobile location most commonly resides.

The home base of a mobile asset is logistics-network detail with no consumer-information function.

Best before date on the label or package signifies the end of the period under which the product will retain specific quality attributes or claims even though the product may continue to retain positive quality attributes after this date.

The best-before date is printed on the label or package by definition and consumers rely on it directly.

The brand of the product that appears on the consumer package.

The brand appears on the consumer package by definition and is core public product identity.

The brand owner of the product.

The brand owner is the accountable party behind the on-package brand and is published in the GS1 registry (Verified by GS1).

Certification information about a product, organisation or location.

Certification claims must be publicly verifiable by the consumers and market-surveillance actors they are addressed to.

Relates to a set of details about the colour code for a product.

Colour codes describe an attribute visible on the product itself and shown in every retail listing.

A description of the colour of an object.

The colour description states an attribute visible on the product itself.

Link to a website, file, or image containing the manufacturer's recommendations for how the consumer or end user should store and handle the product.

The manufacturer's handling and storage recommendations are consumer use-and-maintenance information under ESPR Annex III.

Additional information that should be used in advertising and in displaying.

The package disclaimer is defined as information to be used in advertising and display, i.e. inherently public.

The consumer product variant may be used to distinguish one variant of a retail consumer trade item from another if the change does not require the allocation of a different Global Trade Item Number (per the GTIN Management Standard),...

The consumer product variant distinguishes retail variants under the same GTIN and is by name and purpose consumer-facing.

Information on consumer safety regarding the product.

Safety information exists to protect the end user and must reach every anonymous scanner of the product.

Expresses in text the consumer storage instructions of a product which are normally held on the label or accompanying the product.

Storage instructions are normally held on the label or accompany the product, so they are already public consumer information.

Free text containing the usage instructions of a product, which are normally held on the label or accompanying the product.

Usage instructions are label-carried consumer information ESPR Annex III explicitly directs at customers.

Contact information.

Published contact points are how the organization asks to be reached and are ordinary business-directory content.

The place where product is assembled.

Country of assembly is an origin fact at country granularity, revealing no supplier or facility identity.

The place where the product or ingredient was last processed and tested before importation.

Country of last processing is origin information at country granularity, consistent with on-label origin marking.

Code indicating the country of origin of the product.

Country of origin is a consumer-facing declaration frequently required on the label of the target market.

A description of the geographic area the item may have originated from or has been processed.

The origin statement is the free-text form of the public country-of-origin declaration.

The organization which provides product support to the trading partner organization to which merchandise is sold.

The support-centre contact is printed on packaging precisely so any customer can reach product support.

The name of a division of an organization dealing with a specific activity.

Internal department structure is organizational detail relevant to business partners, not to a consumer scanning a product.

Dependent products are products which are required to make the current product functional.

Products required to make this one functional are compatibility information a purchaser needs before and after buying.

An alphanumeric size factor the brand owner wishes to communicate to the consumer.

The descriptive size is, per its GS1 definition, a size factor the brand owner wishes to communicate to the consumer.

The location reference associated to a digital place.

The digital address points at a publicly reachable digital location and reveals nothing beyond that endpoint.

The name of a digital place.

The name of a digital place (e.g. a webshop) identifies a publicly reachable endpoint.

The date by which an invoice should be paid.

The due date is encodable in the GS1 element string on the payment document itself, so the holder already sees it.

A product which can be substituted for the product based on supplier-defined functional equivalence to the product.

Supplier-declared substitutes help consumers find an equivalent product and are ordinary catalogue information.

The expiration date is the date that determines the limit of consumption or use of a product/coupon.

The expiration date limits safe consumption or use and is printed on the package for the consumer.

The manufacturer determines the expiration date and time, which is relevant only for short duration and for items that will not be sent on long distances and not outside of the time zone.

The expiration date-time is the finer-grained form of the on-package expiration date for short-life products.

The first freeze date is applicable to products that are frozen directly after slaughtering, harvesting, catching or after initial processing of the product.

The first-freeze date is food-quality information consumers use like a best-before date for frozen produce.

Describes use of the product or service by the consumer.

The functional name tells the consumer what the product is used for — ordinary retail product information.

Geographic coordinates (latitude/longitude) of the place.

Coordinates of a GLN-identified business site restate the public location of that site per the GS1 registry (unlike a product's manufacturingPlant link, this describes the place entity itself).

Geographic shape describing the boundary or area covered by the place.

The boundary shape of a GLN-identified site is the same public site-location fact as its coordinates.

Indicates what type of thing is being identified by a GLN.

The GLN type only says what kind of thing the public GLN identifies and is needed to interpret it.

A Global Location Number (GLN) is the GS1 Identification Key used to identify physical locations or parties.

The GLN is the public GS1 identification key for the party or location and is discoverable in the GS1 registry.

8-digit code (GPC Brick Value) specifying a product category according to the GS1 Global Product Classification (GPC) standard.

The GPC brick code is a standard product classification published with the GTIN in the GS1 registry (Verified by GS1).

A description of the code specifying a product category according to the GS1 Global Product Classification (GPC) standard.

The GPC category description is the human-readable form of the public GPC brick code.

The overall area of the item including packaging.

Gross area describes the packaged retail unit and carries no confidential content.

The overall volume of the item including packaging.

Gross volume describes the packaged retail unit and carries no confidential content.

Used to identify the gross weight of the product.

Gross weight describes the packaged retail unit the consumer physically handles.

The process through which fresh produce is grown and cultivated.

The growing method (e.g. organic, hydroponic) is a consumer-facing produce claim shown at point of sale.

A Global Trade Item Number (GTIN) is the 14 digit GS1 Identification Key used to identify products.

The GTIN is encoded in the barcode on every consumer package and is the public key that resolves the ESPR Art. 9 data carrier in the first place.

The harvest date.

The harvest date is provenance information for fresh produce that supports the consumer's freshness and origin judgement.

The harvest end date.

The harvest end date bounds the same public provenance window as the harvest date itself.

The harvest start date.

The harvest start date bounds the same public provenance window as the harvest date itself.

The batch or lot number associates an item with information the manufacturer considers relevant for traceability of the trade item to which the element string is applied.

The batch/lot number is printed on the label and appears in the GS1 Digital Link path the scanner itself resolved.

Links to the place(s) that this organisation designates as their primary location(s).

An organization's self-designated primary location is headline registry identity, like a head-office address.

A serial number is assigned to an entity for its lifetime.

The serial number is marked on the item and appears in the GS1 Digital Link path the scanner itself resolved.

This identifier is assigned to an entity for its lifetime.

A third-party-controlled serial number belongs to an external identification scheme for professional traceability, unlike the on-label GS1 serial.

A description of health claims according to regulations of the target market.

Health claims are made to consumers under target-market regulations and must be as visible as the claim itself.

Referenced image files for the product (flattened plural of the GS1 image link).

Product images are the published visual identity of the product shown in every listing.

Any included object or device not part of the core product itself but which adds to its functionality or use.

Included accessories are box-contents information every retail listing and package already states.

The depth of the product in its packaging, as measured according to the GS1 Package Measurement Rules.

Packaged depth is a measurable fact about the retail unit shown in any product listing.

The measurement of the diameter of the product in its package at its largest point.

Packaged diameter is a measurable fact about the retail unit shown in any product listing.

The height of the product in the package, as measured according to the GS1 Package Measurement Rules.

Packaged height is a measurable fact about the retail unit shown in any product listing.

The width of the product in the package, as measured according to the GS1 Package Measurement Rules.

Packaged width is a measurable fact about the retail unit shown in any product listing.

Link to a file containing the Instructions For Use.

The instructions-for-use file is the document a consumer or repairer needs to use the product correctly (ESPR Annex III).

An indicator for the product to determine if the Manufacturer or Supplier has recalled the product.

Recall status is critical public safety information that must reach every holder of the product without any login.

Links to the organisation (lessor) from which this place is leased.

Lessor identity discloses a commercial lease relationship between businesses.

Links to the organisation(s) (lessee(s)) to which this place is leased.

Lessee identity discloses a commercial lease relationship between businesses.

Links to the place(s) for which this organisation is the lessee (i.e., this organisation leases those places from another organisation, the lessor).

The set of places an organization leases in maps its property dealings — commercial-relations data.

Links to the place(s) for which this organisation is the lessor (i.e., this organisation leases those places to others).

The set of places an organization leases out maps its property dealings — commercial-relations data.

The place(s) associated with an organization.

The places associated with an organization are its public registry footprint of identified sites.

13-digit GLN that is being used to identify a physical or digital location.

The location GLN is the public registry key of the physical or digital location being described.

Provides details on if and when a location is active or inactive.

Activation/deactivation history of a location is registry lifecycle bookkeeping for data managers, not consumer information.

A location classification based on the purpose, type of site and/or what occurs there.

The location role classifies what kind of site a place is — coarse registry classification, not operational detail.

An offer made by an organization.

Offers attached to a party record are commercial trading terms between businesses, not product information for the end user.

Links to the organisation that manages this place or organisation, as designated by the owner or another organisation.

The managing organization behind a site or party discloses an outsourcing/management contract between businesses.

Links to the organisation(s) for whom this place is managed.

Whose behalf a place is managed on discloses the same commercial management relationship as managedBy.

Links to the place(s) or organisation(s) that this organisation manages, on behalf of the owner or another organisation.

The portfolio of places and parties an organization manages enumerates its service contracts — commercial-relations data.

The organization that produces the item.

The producing organization behind a brand is supply-chain sourcing detail; consumers see the brand owner, while manufacturer identity serves authorities and B2B partners.

The warranty associated with the product.

Guarantee and warranty terms are customer information ESPR Annex III expects to be available to product owners.

A physical location consisting of one or more buildings with facilities for manufacturing.

Linking a product to its production facility exposes the manufacturer's production network, which the battery-passport precedent keeps non-public.

The mass per unit area of the item.

Mass per unit area (e.g. fabric grammage) is a physical product characteristic quoted in ordinary retail listings.

The net area of the item.

Net area is a net-quantity measurement of the retail unit, equivalent to on-label content declarations.

The quantity of the product contained by a package, usually as claimed on the label.

Net content is, per its GS1 definition, the quantity as claimed on the label.

Used to identify the net weight of the product.

Net weight is mandatory on-label net-quantity information for consumers.

Links to the organisation(s) that occupy this place.

The tenant list of a site maps commercial occupancy relationships beyond the public operator identity.

Links to the place(s) that this organisation occupies.

The full list of places an organization occupies is operational-footprint detail beyond its public primary location.

Relates to an organic claim about the product.

Organic claims are regulated consumer-facing label claims and must be as visible as the label itself.

Provides details on if and when an organisation/party is active or inactive.

Activation/deactivation history of a party record is registry lifecycle bookkeeping for data managers, not consumer information.

The name of the organization expressed in text.

The organization name is the public legal-entity identity behind the GLN, published via Verified by GS1.

The role and/or purpose of a party (i.e. legal entity or function).

The declared role of a party (e.g. manufacturer, retailer) is coarse registry classification with no commercial detail.

The depth of the product out of its packaging, as measured according to the GS1 Package Measurement Rules.

Unpackaged depth is measurable by anyone holding the product and helps consumers judge fit before purchase.

The measurement of the diameter of the product out of its package at its largest point.

Unpackaged diameter is measurable by anyone holding the product and helps consumers judge fit before purchase.

The height of the product out of the package, as measured according to the GS1 Package Measurement Rules.

Unpackaged height is measurable by anyone holding the product and helps consumers judge fit before purchase.

The width of the product out of the package, as measured according to the GS1 Package Measurement Rules.

Unpackaged width is measurable by anyone holding the product and helps consumers judge fit before purchase.

Links to the organisation(s) that own this place, in full or in part.

Ownership of a site maps commercial relationships and asset holdings beyond the public registry identity of the place.

Links to the place(s) or organisation(s) that this organisation owns.

An organization's owned places and entities enumerate its asset portfolio — commercial detail, not consumer information.

Details on the packaging for a product including type, weight and materials.

Packaging type and material details are consumer-relevant circularity information ESPR Annex I makes central to the passport.

The packaging date is the date when the goods were packed as determined by the packager.

The packaging date is marked on packs (GS1 element strings) and informs the consumer's freshness judgement.

A marking that the product received recognition, endorsement, certification by following guidelines by the label issuing agency.

Accreditation marks are printed on the packaging by definition, so the field only mirrors the label.

Designates the legal entity or function directly above the organisation/party being identified in a hierarchy.

The parent legal entity is corporate-structure information disclosed in public company registers.

13-digit GLN that is being used to identify a legal entity or function.

The party GLN is the public registry key of the legal entity or function being described.

The name of a physical place.

The name of a physical business site is public registry identity, typically also signposted at the site itself.

A product that is similar to the current product but is not exact match.

The primary alternate is a similar-product suggestion of the same public catalogue nature as equivalent products.

Links to the organisation(s) that designate this place as its/their primary location.

The reverse index of every organization headquartered at a place aggregates tenancy relationships beyond any single party's public record.

An understandable and useable description of a product using brand and other descriptors.

The product description is the basic consumer-facing account of what the scanned item is (ESPR Annex III information for customers).

Element for consumer facing marketing content to describe the key features or benefits of the style suitable for display purposes.

Feature-benefit copy is, per its GS1 definition, consumer-facing marketing content suitable for display.

The physical form or shape of the product.

The physical form or shape of the product is apparent from the product itself and its package.

Additional means to the Global Trade Item Number to identify a product.

Additional product identifiers serve the same public identification purpose as the GTIN printed on the package.

The production date is the production or assembly date determined by the manufacturer.

The production date is encodable in the GS1 element strings on the label, so the document repeats on-pack information.

The date and time of production (or assembly).

The production date-time is the finer-grained form of the on-pack production date, not production-process detail.

Free text assigned by the manufacturer to describe the production variant.

Production variants are manufacturer bookkeeping about production runs, not information addressed to the consumer.

The start date of a production variant.

The effective date of a production variant is production bookkeeping tied to the non-public variant record.

Marketing message associated with the product.

The marketing message is authored for consumer display and is public by intent.

Consumer friendly short description of the product suitable for compact presentation.

The consumer-friendly product name is on-package and point-of-sale information every customer already sees.

A name, used by a Brand Owner, that span multiple consumer categories or uses.

The product-range name is public catalogue information the brand owner itself markets across categories.

This term has been deprecated.

Sustainability information is exactly the consumer transparency ESPR exists to deliver through the data carrier.

Free text description of the region or place the product originates from.

The provenance statement is a marketing-grade origin description brands print on the product page and pack.

Link to a file or website containing additional information on product.

Referenced files are links to additional product information the brand publishes for its audience.

The prescribed, regulated or generic product name or denomination that describes the true nature of the product.

The regulated or generic denomination is required on the label to describe the true nature of the product to consumers.

The organisation(s) associated with a place.

The organization associated with a place is the public operator identity a visitor to the site can observe.

Links to the successor organisation that is used in place of a previous organisation.

The successor-organization link keeps the public registry record resolvable after a party is superseded.

Links to the successor location that is used in place of a previous location.

The successor-location link keeps the public registry record resolvable after a location is superseded.

The product which permanently replaces the current product.

The successor-product link routes owners of a discontinued item to its replacement — public catalogue succession.

Links to the previous organisation that this organisation replaces.

The predecessor-organization link is public registry succession history for the party identifier.

Links to the previous location that this location replaces.

The predecessor-location link is public registry succession history for the location identifier.

Indicates the product identification of an item that is being permanently replaced by this product.

The predecessor-product link is the public catalogue history of what this product permanently replaces.

Links to the place(s) for which this organisation is responsible.

The places an organization is responsible for map internal accountability across the site network — B2B operational structure.

Links to the organisation that is directly responsible for this place.

The organization directly responsible for a place is internal accountability structure, distinct from the public operator identity.

The date specified by the manufacturer as the last date the retailer is to offer the product for sale to the consumer.

The sell-by date is marked on retail packaging and lets the consumer judge product freshness at the shelf.

Size codes assigned to the product (flattened plural of the GS1 size code).

Size codes are ordinary retail information printed on the label and shown at point of sale.

Designates a legal entity or function directly below the organisation/party being identified in a hierarchy.

Subsidiary legal entities are corporate-structure information disclosed in public company registers.

Represents the number of days between a product's sell by date and its use by date.

The supplier-specified minimum storage-days figure steers retail shelf-life logistics between trading partners; the consumer relies on the printed dates instead.

Relates to a set of target market details (product release date and associated countries).

Target-market countries and release dates are public availability information visible from where the product is sold.

Links to the place(s) that this organisation uses as a managed space.

Which managed spaces an organization uses reveals its operational footprint and supplier relationships.

Free text field used to identify the variant of the product.

The variant description distinguishes retail variants the consumer chooses between at point of sale.

Warning information is additional information that outlines special requirements, warning and caution information printed on the package.

Warning copy reproduces caution information printed on the package and is critical consumer safety content.