Product
Represents the main entity of the catalog. A product groups general information, metadata, tags, and available variants.
Product Definition
| Property | Type | Description |
|---|---|---|
| id | string (UUID) | Unique identifier of the product. |
| name | string | Name of the product. |
| metadata | Object | Key-value object for additional custom data. |
| assets | Asset[] | Array of the product's main multimedia resources (images, videos). |
| tags | Tag[] | List of tags associated with the product along with their values. |
| attributes | Attribute[] | List of technical attributes and their values for this product. |
| options | Option[] | Definitions of available options (e.g., Size, Color) used to generate variants. |
| reviews | Object | Contains rating (average score) and count (number of reviews). |
| variants | Variant[] | Array of specific variants belonging to this product. |
Object example
{
"data": {
"id": "6cd8ad36-21eb-4c1c-b554-58315b70fed3",
"name": "Nike Pegasus 41",
"description": "",
"metadata": {},
"assets": [],
"tags": [
{
"id": "fb762f0d-1bb6-414a-837e-06f0b996b06d",
"name": "Collection",
"relevant": false,
"sortable": false,
"filterable": false,
"type": "string",
"values": [
{
"id": "82728997-b2df-411d-87cb-7bc5ee0809e5",
"value": "Clothing",
"alias": ""
}
]
},
{
"id": "bbbdb0e1-0829-43a6-867d-2f26b2b2186f",
"name": "Brand",
"relevant": true,
"sortable": false,
"filterable": true,
"type": "string",
"values": [
{
"id": "05b3701e-c6ba-44b1-afd9-a7f0e168b031",
"value": "Nike",
"alias": ""
}
]
}
],
"options": [
{
"id": "2d395c94-552a-4dbf-95de-230f94e0844c",
"name": "Shoes Size (EU)",
"type": "tagValue",
"position": 0,
"values": [
{
"optionId": "2d395c94-552a-4dbf-95de-230f94e0844c",
"optionValueId": "eccd7e69-2aa2-4bbc-92ef-75a07f0a01e6",
"tagValueId": "23198742-55f6-454d-bfad-ddb50caef452",
"tagValue": "40",
"position": 0
},
{
"optionId": "2d395c94-552a-4dbf-95de-230f94e0844c",
"optionValueId": "c0a8d6b1-3c4b-4086-b7f3-d9bf9e3ee667",
"tagValueId": "ed768bf7-1e9c-4203-92bf-92d22a704ba0",
"tagValue": "40.5",
"position": 1
},
{
"optionId": "2d395c94-552a-4dbf-95de-230f94e0844c",
"optionValueId": "f5037d14-b7f4-4995-a806-33cf87a67d53",
"tagValueId": "e05abd72-46e0-4d61-8a54-1ab0a9d630fb",
"tagValue": "41",
"position": 2
},
{
"optionId": "2d395c94-552a-4dbf-95de-230f94e0844c",
"optionValueId": "75c5637e-155a-4e9a-93a8-c9768c16d54b",
"tagValueId": "6bb35d28-b17d-43a2-a25e-3e7939c0c38e",
"tagValue": "41.5",
"position": 3
},
{
"optionId": "2d395c94-552a-4dbf-95de-230f94e0844c",
"optionValueId": "9e1f3977-fbe7-4b15-a86c-f668f3613b6c",
"tagValueId": "76faad43-cf87-4801-9a52-f7d890213934",
"tagValue": "42",
"position": 4
},
{
"optionId": "2d395c94-552a-4dbf-95de-230f94e0844c",
"optionValueId": "91ccf4c6-3b63-4506-a022-f84c7937e660",
"tagValueId": "5b0ff2a9-17e7-4180-9721-7b238f0fafc7",
"tagValue": "42.5",
"position": 5
},
{
"optionId": "2d395c94-552a-4dbf-95de-230f94e0844c",
"optionValueId": "28e5f74e-0d22-4efd-8f51-2e41e3c2f552",
"tagValueId": "e2492896-dcb8-4d2b-a9a4-3f57e6909d2d",
"tagValue": "43",
"position": 6
},
{
"optionId": "2d395c94-552a-4dbf-95de-230f94e0844c",
"optionValueId": "443a3cf5-a554-4ded-a91e-22dd64935bc4",
"tagValueId": "c17dee86-4a6d-4574-9222-1c454e1d0b94",
"tagValue": "43.5",
"position": 7
},
{
"optionId": "2d395c94-552a-4dbf-95de-230f94e0844c",
"optionValueId": "c1ea3f5b-5f96-4859-8e49-13a3b2bad39d",
"tagValueId": "5bf79572-cb28-4104-9ace-9c453f37bbce",
"tagValue": "44",
"position": 8
},
{
"optionId": "2d395c94-552a-4dbf-95de-230f94e0844c",
"optionValueId": "3f74d3f7-3660-4485-9c2c-45f01fda43e9",
"tagValueId": "4bf366e2-1678-4784-a11f-d53c786104a3",
"tagValue": "44.5",
"position": 9
}
]
}
],
"attributes": [
{
"id": "3aac3a70-826d-48f2-809d-fc3992420829",
"name": "Date",
"relevant": true,
"sortable": true,
"type": "date",
"format": "date",
"icon": "react-icons/io5#IoCalendarNumber",
"value": "2025-12-15T21:14:00+01:00"
},
{
"id": "71ce9ece-b772-4254-be20-ea0e7781ebc5",
"name": "Number",
"relevant": true,
"sortable": true,
"type": "number",
"value": "14"
}
],
"reviews": {
"rating": 5,
"count": 1
},
"variants": [
{
"id": "08d2a27f-19b4-41aa-b380-ddebb01ac6d4",
"name": "Nike Pegasus",
"slug": "nike-pegasus-704a84-eedb47",
"metadata": {},
"isFavourite": false,
"productId": "6cd8ad36-21eb-4c1c-b554-58315b70fed3",
"availability": "available",
"inheritAssets": true,
"inheritAttributes": true,
"inheritTagValues": true,
"tags": [
{
"id": "54cd9e5f-7b22-4a69-a623-b37e62751bfb",
"name": "Shoes size (EU)",
"relevant": false,
"sortable": false,
"filterable": true,
"type": "number",
"format": null,
"icon": "",
"values": [
{
"alias": "",
"id": "23198742-55f6-454d-bfad-ddb50caef452",
"value": "40"
},
{
"alias": "",
"id": "ed768bf7-1e9c-4203-92bf-92d22a704ba0",
"value": "40.5"
},
{
"alias": "",
"id": "e05abd72-46e0-4d61-8a54-1ab0a9d630fb",
"value": "41"
},
{
"alias": "",
"id": "6bb35d28-b17d-43a2-a25e-3e7939c0c38e",
"value": "41.5"
},
{
"alias": "",
"id": "76faad43-cf87-4801-9a52-f7d890213934",
"value": "42"
},
{
"alias": "",
"id": "5b0ff2a9-17e7-4180-9721-7b238f0fafc7",
"value": "42.5"
},
{
"alias": "",
"id": "e2492896-dcb8-4d2b-a9a4-3f57e6909d2d",
"value": "43"
},
{
"alias": "",
"id": "c17dee86-4a6d-4574-9222-1c454e1d0b94",
"value": "43.5"
},
{
"alias": "",
"id": "5bf79572-cb28-4104-9ace-9c453f37bbce",
"value": "44"
},
{
"alias": "",
"id": "4bf366e2-1678-4784-a11f-d53c786104a3",
"value": "44.5"
}
]
},
{
"id": "1c0edb9e-c2fd-41eb-960a-f17723beeb52",
"name": "Color",
"relevant": true,
"sortable": false,
"filterable": true,
"type": "string",
"format": null,
"icon": "",
"values": [
{
"alias": "",
"id": "9538621f-c258-4793-87d5-7a112e20a3e1",
"value": "Green"
},
{
"alias": "",
"id": "01f6db41-6454-4be9-9c76-2e45ae0b6db6",
"value": "Black"
}
]
}
],
"assets": [
{
"id": "96228bd5-5dd5-417c-9c74-4f4df3f53efe",
"url": "https://webrounddev.b-cdn.net/rMa8bmEA2Yg9aYk5PgZPejecmIB2/a7734977-c5b1-49a4-911c-0b0bf745bd4f/commerce/images/1764668133827-Immagine_incollata.png",
"type": "image",
"position": 0,
"thumbnail": "",
"inherited": false
}
],
"attributes": [],
"priceRanges": [
{
"currencyCode": "EUR",
"cadence": "once",
"netMin": 139,
"netMax": 139,
"grossMin": 169.57999999999998,
"grossMax": 169.57999999999998,
"compareNetMin": 0,
"compareNetMax": 0,
"compareGrossMin": 0,
"compareGrossMax": 0,
"rate": 22
}
],
"skus": [
{
"allowFreeShipping": false,
"backorderDays": 0,
"quantity": 9,
"allowBackorder": false,
"mpn": "",
"ean": "",
"forceFreeShipping": false,
"options": {
"2d395c94-552a-4dbf-95de-230f94e0844c": "eccd7e69-2aa2-4bbc-92ef-75a07f0a01e6"
},
"purchaseRestock": false,
"sku": "NIK-A6B512-283BBA",
"prices": [
{
"amount": 139,
"isDefault": true,
"comparePrice": 0,
"quantityTable": null,
"externalId": "",
"id": "3ec67ca3-1563-4161-b90e-e144d5a8f206",
"currencyCode": "EUR",
"cadence": "once",
"netAmount": 139,
"grossAmount": 169.57999999999998,
"rate": 22,
"netCompare": 0,
"grossCompare": 0
}
],
"isFavourite": false,
"maxOrderQuantity": 30,
"id": "cc026e04-9eb0-4d6f-aa72-a782eb9550db"
},
{
"allowFreeShipping": false,
"backorderDays": 0,
"quantity": 10,
"allowBackorder": false,
"mpn": "",
"ean": "",
"forceFreeShipping": false,
"options": {
"2d395c94-552a-4dbf-95de-230f94e0844c": "c0a8d6b1-3c4b-4086-b7f3-d9bf9e3ee667"
},
"purchaseRestock": false,
"sku": "NIK-EE3B92-DA29A6",
"prices": [
{
"amount": 139,
"isDefault": true,
"comparePrice": 0,
"quantityTable": null,
"externalId": "",
"id": "d355d868-07ae-4a87-8711-621934f84e7e",
"currencyCode": "EUR",
"cadence": "once",
"netAmount": 139,
"grossAmount": 169.57999999999998,
"rate": 22,
"netCompare": 0,
"grossCompare": 0
}
],
"isFavourite": false,
"maxOrderQuantity": 30,
"id": "2e2aa871-c1b5-4323-bded-7f22947fe605"
},
{
"allowFreeShipping": false,
"backorderDays": 0,
"quantity": 10,
"allowBackorder": false,
"mpn": "",
"ean": "",
"forceFreeShipping": false,
"options": {
"2d395c94-552a-4dbf-95de-230f94e0844c": "f5037d14-b7f4-4995-a806-33cf87a67d53"
},
"purchaseRestock": false,
"sku": "NIK-EAF7EE-C2179F",
"prices": [
{
"amount": 139,
"isDefault": true,
"comparePrice": 0,
"quantityTable": null,
"externalId": "",
"id": "03bee824-bdcc-4c64-be4b-2efa8482f2f1",
"currencyCode": "EUR",
"cadence": "once",
"netAmount": 139,
"grossAmount": 169.57999999999998,
"rate": 22,
"netCompare": 0,
"grossCompare": 0
}
],
"isFavourite": false,
"maxOrderQuantity": 30,
"id": "25abe8fb-91bc-40e0-a7a8-59cfaeabf200"
}
]
},
{
"id": "5866824d-7f90-4bba-9574-b7cb775bfaf7",
"name": "Nike Pegasus",
"slug": "nike-pegasus-526f28",
"metadata": {},
"isFavourite": false,
"productId": "6cd8ad36-21eb-4c1c-b554-58315b70fed3",
"availability": "available",
"inheritAssets": true,
"inheritAttributes": true,
"inheritTagValues": true,
"tags": [
{
"id": "54cd9e5f-7b22-4a69-a623-b37e62751bfb",
"name": "Shoes Size (EU)",
"relevant": false,
"sortable": false,
"filterable": true,
"type": "number",
"format": null,
"icon": "",
"values": [
{
"alias": "",
"id": "23198742-55f6-454d-bfad-ddb50caef452",
"value": "40"
},
{
"alias": "",
"id": "ed768bf7-1e9c-4203-92bf-92d22a704ba0",
"value": "40.5"
},
{
"alias": "",
"id": "e05abd72-46e0-4d61-8a54-1ab0a9d630fb",
"value": "41"
},
{
"alias": "",
"id": "6bb35d28-b17d-43a2-a25e-3e7939c0c38e",
"value": "41.5"
},
{
"alias": "",
"id": "76faad43-cf87-4801-9a52-f7d890213934",
"value": "42"
},
{
"alias": "",
"id": "5b0ff2a9-17e7-4180-9721-7b238f0fafc7",
"value": "42.5"
},
{
"alias": "",
"id": "e2492896-dcb8-4d2b-a9a4-3f57e6909d2d",
"value": "43"
},
{
"alias": "",
"id": "c17dee86-4a6d-4574-9222-1c454e1d0b94",
"value": "43.5"
},
{
"alias": "",
"id": "5bf79572-cb28-4104-9ace-9c453f37bbce",
"value": "44"
},
{
"alias": "",
"id": "4bf366e2-1678-4784-a11f-d53c786104a3",
"value": "44.5"
}
]
},
{
"id": "1c0edb9e-c2fd-41eb-960a-f17723beeb52",
"name": "Color",
"relevant": true,
"sortable": false,
"filterable": true,
"type": "string",
"format": null,
"icon": "",
"values": [
{
"alias": "",
"id": "cc88ee22-86eb-409f-991d-8dff13608197",
"value": "White"
}
]
}
],
"assets": [
{
"id": "2606fc94-44c3-48d5-85da-5def06af3cee",
"url": "https://webrounddev.b-cdn.net/rMa8bmEA2Yg9aYk5PgZPejecmIB2/a7734977-c5b1-49a4-911c-0b0bf745bd4f/commerce/images/1764668134556-Immagine_incollata__2_.png",
"type": "image",
"position": 0,
"thumbnail": "",
"inherited": false
}
],
"attributes": [],
"priceRanges": [
{
"currencyCode": "EUR",
"cadence": "once",
"netMin": 139,
"netMax": 140,
"grossMin": 169.57999999999998,
"grossMax": 170.79999999999998,
"compareNetMin": 0,
"compareNetMax": 0,
"compareGrossMin": 0,
"compareGrossMax": 0,
"rate": 22
}
],
"skus": [
{
"allowFreeShipping": false,
"backorderDays": 0,
"quantity": 8,
"allowBackorder": false,
"mpn": "",
"ean": "",
"forceFreeShipping": false,
"options": {
"2d395c94-552a-4dbf-95de-230f94e0844c": "eccd7e69-2aa2-4bbc-92ef-75a07f0a01e6"
},
"purchaseRestock": false,
"sku": "NIK-E172D4-FAE227",
"prices": [
{
"amount": 140,
"isDefault": true,
"comparePrice": 0,
"quantityTable": null,
"externalId": null,
"id": "d6b5e7a9-d202-4e25-a579-e4875c2ca3b8",
"currencyCode": "EUR",
"cadence": "once",
"netAmount": 140,
"grossAmount": 170.79999999999998,
"rate": 22,
"netCompare": 0,
"grossCompare": 0
}
],
"isFavourite": false,
"maxOrderQuantity": 30,
"id": "9fd983d3-17f0-409c-b29e-f51188be51c3"
},
{
"allowFreeShipping": false,
"backorderDays": 0,
"quantity": 10,
"allowBackorder": false,
"mpn": "",
"ean": "",
"forceFreeShipping": false,
"options": {
"2d395c94-552a-4dbf-95de-230f94e0844c": "c0a8d6b1-3c4b-4086-b7f3-d9bf9e3ee667"
},
"purchaseRestock": false,
"sku": "NIK-95A109-B0BA52",
"prices": [
{
"amount": 139,
"isDefault": true,
"comparePrice": 0,
"quantityTable": null,
"externalId": "",
"id": "c3227cbc-78be-4982-8db1-be8d9d3d5f13",
"currencyCode": "EUR",
"cadence": "once",
"netAmount": 139,
"grossAmount": 169.57999999999998,
"rate": 22,
"netCompare": 0,
"grossCompare": 0
}
],
"isFavourite": false,
"maxOrderQuantity": 30,
"id": "e8a08fc3-46c8-4edc-b4e0-17e09df63273"
}
]
}
]
}
}