Draft 0.2 – open for comment. Changes are expected.

Give feedback

Core

Record information, identity, brand, manufacturer, variants, contents, child suitability, dimensions, weights, logistics, texts and lifecycle status of a product.

Block: Core · Specification 0.2

The core applies to every product, whatever its category. It identifies the product variant, names the brand and the manufacturer, and holds the measurements and texts that every channel needs.

Rules at a glance

  • Who publishes the record. recordInfo names the publisher and its role – brand owner, manufacturer, importer, distributor, retailer or service provider – and the time of the last change. Data recipients use it to detect changes and to tell records for the same GTIN apart.
  • One record per variant. Each GTIN has its own record. Variants of the same model share productGroupId and differ in variant; variant.variesBy names the attributes in which they differ.
  • Sets and bundles. contents lists everything in the package. A set sold under its own GTIN is one record; components that are also sold on their own carry their GTIN.
  • Manufacturer details are mandatory. The General Product Safety Regulation (GPSR, Art. 19) requires every online offer to show the manufacturer’s name, postal and electronic address. manufacturer therefore MUST contain name, postalAddress and email.
  • EU responsible person. When the manufacturer is established outside the EU, the record MUST contain euResponsiblePerson. The schema checks this against manufacturer.postalAddress.country.
  • Category decides the profile. category.code determines which category profile applies. Records with the code stroller MUST contain profiles.stroller, records with the code car-seat MUST contain profiles.carSeat.
  • Texts per language. Titles, descriptions and features are localized strings.
Core: fields 106 fields, generated from core.schema.json
Field Type Level Description Example
$schema Link to field $schema string (URI) MAY

URI of the schema the record conforms to, so that editors can validate it.

https://openjuvenile.org/schemas/v0.2/core.schema.json
specVersion Link to field specVersion string MUST

Version of the specification the record conforms to.

Values:
  • 0.2
0.2
recordInfo Link to field recordInfo object MUST

Information about the record itself: who publishes it, when it was last changed and how final it is. Data recipients use it to detect changes and to tell records for the same GTIN apart.

recordInfo. publisher Link to field recordInfo.publisher object MUST

The company that publishes this record and answers questions about its data.

recordInfo.publisher. name Link to field recordInfo.publisher.name string MUST

Name of the company.

Example Brand Ltd.
recordInfo.publisher. gln Link to field recordInfo.publisher.gln string SHOULD

Global Location Number (GLN) of the publishing company.

9521234000006
recordInfo.publisher. role Link to field recordInfo.publisher.role string MUST

Role of the publisher for this product: brand-owner (owns the brand) · manufacturer · importer · distributor · retailer · service-provider (publishes on behalf of one of the others).

Values:
  • brand-owner
  • manufacturer
  • importer
  • distributor
  • retailer
  • service-provider
brand-owner
recordInfo. lastModified Link to field recordInfo.lastModified string MUST

Date and time of the last change to the record, in ISO 8601 format with time zone.

2026-09-15T09:30:00Z
recordInfo. revision Link to field recordInfo.revision integer SHOULD

Revision number of the record. It increases by at least one with every change the publisher releases.

3
recordInfo. status Link to field recordInfo.status string SHOULD

preliminary: values may still change, for example before the launch · final: values are confirmed by the publisher.

Values:
  • preliminary
  • final
final
recordInfo. recordId Link to field recordInfo.recordId string MAY

Identifier of the record in the publisher's own system.

PIM-000123
gtin Link to field gtin string (GTIN) MUST

Global Trade Item Number of this product variant: 8, 12, 13 or 14 digits with a valid check digit. Primary identifier of the record.

9521234567899
brand Link to field brand object MUST

The brand under which the product is sold.

brand. name Link to field brand.name string MUST

Brand name as shown on the product and its packaging.

Example Brand
brand. website Link to field brand.website string (URL) MAY

Website of the brand.

https://example.com
manufacturer Link to field manufacturer object MUST

The manufacturer of the product. GPSR Art. 19 requires the manufacturer's name, postal and electronic address in every online offer.

manufacturer. name Link to field manufacturer.name string MUST

Name of the company.

Example Brand Ltd.
manufacturer. postalAddress Link to field manufacturer.postalAddress object MUST

Postal address at which the company can be contacted.

manufacturer.postalAddress. streetAddress Link to field manufacturer.postalAddress.streetAddress string MUST

Street and house number, or post office box.

1 Example Street
manufacturer.postalAddress. postalCode Link to field manufacturer.postalAddress.postalCode string SHOULD

Postal code, if the country uses postal codes.

1010
manufacturer.postalAddress. locality Link to field manufacturer.postalAddress.locality string MUST

City or town.

Example City
manufacturer.postalAddress. region Link to field manufacturer.postalAddress.region string MAY

State, province or region, where part of the address.

manufacturer.postalAddress. country Link to field manufacturer.postalAddress.country string (country code) MUST

Country of the address (ISO 3166-1 alpha-2).

AT
manufacturer. email Link to field manufacturer.email string (email) MUST

Electronic address at which the company can be contacted.

productsafety@example.com
manufacturer. website Link to field manufacturer.website string (URL) SHOULD

Website of the company.

https://example.com
euResponsiblePerson Link to field euResponsiblePerson object MUST if

Required if: The manufacturer is established outside the EU (manufacturer.postalAddress.country is not an EU member state).

The person established in the EU who is responsible for the product when the manufacturer is established outside the EU (GPSR Art. 19).

euResponsiblePerson. name Link to field euResponsiblePerson.name string MUST

Name of the company or person.

Example EU Representative GmbH
euResponsiblePerson. postalAddress Link to field euResponsiblePerson.postalAddress object MUST

Postal address in the EU.

euResponsiblePerson.postalAddress. streetAddress Link to field euResponsiblePerson.postalAddress.streetAddress string MUST

Street and house number, or post office box.

1 Example Street
euResponsiblePerson.postalAddress. postalCode Link to field euResponsiblePerson.postalAddress.postalCode string SHOULD

Postal code, if the country uses postal codes.

1010
euResponsiblePerson.postalAddress. locality Link to field euResponsiblePerson.postalAddress.locality string MUST

City or town.

Example City
euResponsiblePerson.postalAddress. region Link to field euResponsiblePerson.postalAddress.region string MAY

State, province or region, where part of the address.

euResponsiblePerson.postalAddress. country Link to field euResponsiblePerson.postalAddress.country string (country code) MUST

Country of the address (ISO 3166-1 alpha-2).

AT
euResponsiblePerson. email Link to field euResponsiblePerson.email string (email) MUST

Electronic address at which the responsible person can be contacted.

productsafety@example.com
modelName Link to field modelName string MUST

Model name as used by the brand, without variant details such as colour.

Pebble Travel Stroller
modelNumber Link to field modelNumber string SHOULD

The manufacturer's article number for this model or variant.

EB-PTS-26
modelYear Link to field modelYear integer MAY

Model year as communicated by the brand.

2026
productGroupId Link to field productGroupId string SHOULD

Identifier, assigned by the brand, that all variants of one model share – for example the model number without the colour code. Records with the same brand.name and productGroupId are variants of one model.

EB-PTS
variant Link to field variant object SHOULD

What distinguishes this variant from other variants of the same model.

variant. colorName Link to field variant.colorName localized string SHOULD

Colour name as communicated to consumers, per language.

variant. colorCode Link to field variant.colorCode string MAY

Colour code used by the brand in its own systems.

GRA
variant. size Link to field variant.size string MAY

Size designation, if the model is available in sizes.

74/80
variant. variesBy Link to field variant.variesBy array of strings (min. 1) MAY

Attributes in which the variants of this model differ from each other.

variant. pattern Link to field variant.pattern localized string MAY

Name of the pattern or print, per language, if the variants differ in it.

category Link to field category object MUST

Product category. The category code determines which category profile applies.

category. code Link to field category.code string MUST

Category code of this standard. Records with code stroller or car-seat MUST contain the matching profile.

Values:
  • stroller
  • car-seat
  • nursery-furniture
  • mattress
  • carrier
  • feeding
  • textile
  • safety-product
  • toy
  • other
stroller
category. gs1GpcBrick Link to field category.gs1GpcBrick string SHOULD

GS1 Global Product Classification (GPC) brick code: 8 digits.

title Link to field title localized string MUST

Product title for listings, per language.

shortDescription Link to field shortDescription localized string SHOULD

One or two sentences that describe the product, per language.

description Link to field description localized string SHOULD

Full product description, per language. Plain text; paragraphs are separated by a blank line.

keyFeatures Link to field keyFeatures array of localized strings (min. 1) MAY

Short feature statements in order of importance, each per language.

contents Link to field contents array of objects (min. 1) SHOULD

What the customer receives: every item in the package, including the product itself, accessories and parts. For sets and bundles, each component is one entry.

contents[]. name Link to field contents[].name localized string MUST

Name of the item, per language.

contents[]. quantity Link to field contents[].quantity integer MUST

Number of these items in the package.

1
contents[]. gtin Link to field contents[].gtin string (GTIN) MUST if

Required if: The item is also sold on its own.

GTIN of the item, if it is also sold on its own.

9521234567899
childSuitability Link to field childSuitability object SHOULD

Which children the product is intended for, as stated by the manufacturer. Category profiles add limits for parts of a product, such as the seat of a stroller.

childSuitability. fromBirth Link to field childSuitability.fromBirth boolean SHOULD

Whether the product can be used from birth.

true
childSuitability. ageMonths Link to field childSuitability.ageMonths object SHOULD

Age range in months.

childSuitability.ageMonths. min Link to field childSuitability.ageMonths.min number SHOULD

Lower limit (inclusive).

0
childSuitability.ageMonths. max Link to field childSuitability.ageMonths.max number SHOULD

Upper limit (inclusive).

22
childSuitability. childWeightKg Link to field childSuitability.childWeightKg object MAY

Range of the child's weight in kg.

childSuitability.childWeightKg. min Link to field childSuitability.childWeightKg.min number SHOULD

Lower limit (inclusive).

0
childSuitability.childWeightKg. max Link to field childSuitability.childWeightKg.max number SHOULD

Upper limit (inclusive).

22
childSuitability. childHeightCm Link to field childSuitability.childHeightCm object MAY

Range of the child's height (stature) in cm.

childSuitability.childHeightCm. min Link to field childSuitability.childHeightCm.min number SHOULD

Lower limit (inclusive).

0
childSuitability.childHeightCm. max Link to field childSuitability.childHeightCm.max number SHOULD

Upper limit (inclusive).

22
dimensions Link to field dimensions object MUST

Outer dimensions in centimetres.

dimensions. assembled Link to field dimensions.assembled object MUST

Dimensions of the product ready for use.

dimensions.assembled. lengthCm Link to field dimensions.assembled.lengthCm number MUST

Length (depth) in cm.

85
dimensions.assembled. widthCm Link to field dimensions.assembled.widthCm number MUST

Width in cm.

48
dimensions.assembled. heightCm Link to field dimensions.assembled.heightCm number MUST

Height in cm.

104
dimensions. packaged Link to field dimensions.packaged object SHOULD

Dimensions of the retail packaging. For products shipped in more than one package, use logistics.packages.

dimensions.packaged. lengthCm Link to field dimensions.packaged.lengthCm number MUST

Length (depth) in cm.

85
dimensions.packaged. widthCm Link to field dimensions.packaged.widthCm number MUST

Width in cm.

48
dimensions.packaged. heightCm Link to field dimensions.packaged.heightCm number MUST

Height in cm.

104
weight Link to field weight object MUST

Weights in kilograms.

weight. netKg Link to field weight.netKg number MUST

Weight of the product without packaging, in kg.

6.9
weight. grossKg Link to field weight.grossKg number SHOULD

Weight including the retail packaging, in kg. For products shipped in more than one package, use logistics.packages.

8.4
logistics Link to field logistics object SHOULD

Packages and trade units for ordering, storage and shipping.

logistics. packages Link to field logistics.packages array of objects (min. 2) MUST if

Required if: The product is shipped in more than one package.

The packages of the product, if it is shipped in more than one package (for example frame and seat unit in separate boxes).

logistics.packages[]. dimensions Link to field logistics.packages[].dimensions object MUST

Outer dimensions of the package.

logistics.packages[].dimensions. lengthCm Link to field logistics.packages[].dimensions.lengthCm number MUST

Length (depth) in cm.

85
logistics.packages[].dimensions. widthCm Link to field logistics.packages[].dimensions.widthCm number MUST

Width in cm.

48
logistics.packages[].dimensions. heightCm Link to field logistics.packages[].dimensions.heightCm number MUST

Height in cm.

104
logistics.packages[]. grossKg Link to field logistics.packages[].grossKg number MUST

Weight of the package including its contents, in kg.

9.2
logistics.packages[]. contentsNote Link to field logistics.packages[].contentsNote localized string MAY

What the package contains, per language.

logistics. tradeUnits Link to field logistics.tradeUnits array of objects (min. 1) SHOULD

Units in which the product is ordered and shipped, such as cases and pallets.

logistics.tradeUnits[]. level Link to field logistics.tradeUnits[].level string MUST

inner-pack · case · pallet.

Values:
  • inner-pack
  • case
  • pallet
case
logistics.tradeUnits[]. gtin Link to field logistics.tradeUnits[].gtin string (GTIN) MUST

GTIN of the trade unit, usually a GTIN-14.

9521234567899
logistics.tradeUnits[]. quantity Link to field logistics.tradeUnits[].quantity integer MUST

Number of consumer units (this product) in the trade unit.

2
logistics.tradeUnits[]. dimensions Link to field logistics.tradeUnits[].dimensions object SHOULD

Outer dimensions of the trade unit.

logistics.tradeUnits[].dimensions. lengthCm Link to field logistics.tradeUnits[].dimensions.lengthCm number MUST

Length (depth) in cm.

85
logistics.tradeUnits[].dimensions. widthCm Link to field logistics.tradeUnits[].dimensions.widthCm number MUST

Width in cm.

48
logistics.tradeUnits[].dimensions. heightCm Link to field logistics.tradeUnits[].dimensions.heightCm number MUST

Height in cm.

104
logistics.tradeUnits[]. grossKg Link to field logistics.tradeUnits[].grossKg number SHOULD

Gross weight of the trade unit, in kg.

17.6
countryOfOrigin Link to field countryOfOrigin string (country code) SHOULD

Country of origin of the product.

AT
lifecycle Link to field lifecycle object SHOULD

Market status of the product.

lifecycle. status Link to field lifecycle.status string MUST

announced: not yet available · active: available · discontinued: no longer produced.

Values:
  • announced
  • active
  • discontinued
active
lifecycle. launchDate Link to field lifecycle.launchDate string (date) SHOULD

Date from which the product is or was available.

2026-02-01
lifecycle. discontinuedDate Link to field lifecycle.discontinuedDate string (date) MUST if

Required if: status is discontinued.

Date from which the product is no longer produced.

2026-02-01
profiles Link to field profiles object MUST if

Required if: category.code has a category profile (stroller, car-seat).

Category profiles with category-specific fields, keyed by profile key: stroller and carSeat. The profile that matches category.code MUST be present.

profiles. stroller Link to field profiles.stroller object MUST if

Required if: category.code is stroller.

Profile for strollers, prams and buggies.

Fields of this module

profiles. carSeat Link to field profiles.carSeat object MUST if

Required if: category.code is car-seat.

Profile for child car seats.

Fields of this module

compliance Link to field compliance object MUST

Compliance block: markets, regulations, standards, test reports, warnings and Digital Product Passport.

Fields of this module

media Link to field media object MUST

Media block: images, documents, videos and 3D/AR models.

Fields of this module

compatibility Link to field compatibility object MAY

Compatibility block: products this product can be combined with.

Fields of this module

Child suitability

childSuitability states which children the product is intended for: from birth or not, and ranges for age, weight and height. Ranges are written as { "min": …, "max": … }; the unit is part of the field name, as in childWeightKg. Category profiles add limits for parts of a product, such as the seat of a stroller or the approval range of a car seat.

Measurements and logistics

dimensions.assembled describes the product ready for use. Category profiles add measurements that matter for the category, such as the folded size of a stroller. All dimensions are given in centimetres, all weights in kilograms.

dimensions.packaged and weight.grossKg describe a product in one retail package. Products shipped in more than one package list each package in logistics.packages. logistics.tradeUnits describes cases and pallets with their own GTIN and the number of products they contain.

Lifecycle

lifecycle.status tells data recipients whether a product is announced, available or discontinued. A discontinued product keeps its record, so that safety information and spare parts stay findable.