Documentation
Feedback
Guides
API Reference

Guides
Catalog
Products

A product is a generic definition of an item that is part of your store’s Catalog, for instance, a shirt.

Products may vary by model, color, size, among other characteristics. Therefore, it would be possible to have the same product (shirt) in different models, like short or long sleeves, gray or pink color, sizes S, M or L.

Each variation, such as a long sleeve gray size S shirt, will correspond to a Stock Keeping Unit (SKU), which is the actual item in the inventory that customers can purchase. Before creating SKUs, you must create a product.

Try the interactive version of this article by accessing this link. Code will be highlighted and focused for your convenience.

Create a product

To insert a new product, use the Create product API endpoint.

When creating or updating products, note that any product must be associated with their corresponding category in the more specific category level.

We recommend leaving VTEX to automatically generate an ID, by not including a custom product ID in the Id field of the request body. The generated ID can be retrieved in the request's response and must be stored in the system for future updates of this product.

Request body example


_18
{
_18
"Id": null,
_18
"Name": "Zoom Stefan Janoski Canvas RM SB Varsity Red",
_18
"DepartmentId": 2000089,
_18
"CategoryId": 2000090,
_18
"BrandId": 12121219,
_18
"LinkId": "stefan-janoski-canvas-varsity-red",
_18
"RefId": "sr_1_90",
_18
"IsVisible": true,
_18
"Description": "The Nike Zoom Stefan Janoski Men's Shoe is made with a premium leather upper for superior durability and a flexible midsole for all-day comfort. A tacky gum rubber outsole delivers outstanding traction.",
_18
"DescriptionShort": "The Nike Zoom Stefan Janoski is made with a premium leather.",
_18
"ReleaseDate": "2023-01-01T00:00:00",
_18
"KeyWords": "Zoom,Stefan,Janoski",
_18
"Title": "Zoom Stefan Janoski Canvas RM SB Varsity Red",
_18
"IsActive": true,
_18
"MetaTagDescription": "The Nike Zoom Stefan Janoski Men's Shoe is made with a premium leather upper for superior durability and a flexible midsole for all-day comfort. A tacky gum rubber outsole delivers outstanding traction.",
_18
"ShowWithoutStock": true,
_18
}

Response body example


_23
{
_23
"Id": 42,
_23
"Name": "Zoom Stefan Janoski Canvas RM SB Varsity Red",
_23
"DepartmentId": 2000089,
_23
"CategoryId": 2000090,
_23
"BrandId": 12121219,
_23
"LinkId": "stefan-janoski-canvas-varsity-red",
_23
"RefId": "sr_1_90",
_23
"IsVisible": true,
_23
"Description": "The Nike Zoom Stefan Janoski Men's Shoe is made with a premium leather upper for superior durability and a flexible midsole for all-day comfort. A tacky gum rubber outsole delivers outstanding traction.",
_23
"DescriptionShort": "The Nike Zoom Stefan Janoski is made with a premium leather.",
_23
"ReleaseDate": "2023-01-01T00:00:00",
_23
"KeyWords": "Zoom,Stefan,Janoski",
_23
"Title": "Zoom Stefan Janoski Canvas RM SB Varsity Re",
_23
"IsActive": true,
_23
"TaxCode": "",
_23
"MetaTagDescription": "The Nike Zoom Stefan Janoski Men's Shoe is made with a premium leather upper for superior durability and a flexible midsole for all-day comfort. A tacky gum rubber outsole delivers outstanding traction.",
_23
"SupplierId": 1,
_23
"ShowWithoutStock": true,
_23
"AdWordsRemarketingCode": null,
_23
"LomadeeCampaignCode": null,
_23
"Score": 1
_23
}

Update a product

In case you have already created a product and want to change it, use the Update product API request, sending in the Id of the product already created.

If you need to change any product field, it is necessary to send all the other fields in the request. Otherwise, all previously configured information from blank fields will be deleted. Therefore, before making a change, you should get the product data for the same Id and use the response as a template to make the change.

Request body example


_23
{
_23
"Id": 42,
_23
"Name": "Zoom Stefan Janoski Canvas RM SB Varsity Red",
_23
"DepartmentId": 2000089,
_23
"CategoryId": 2000090,
_23
"BrandId": 12121219,
_23
"LinkId": "stefan-janoski-canvas-varsity-red",
_23
"RefId": "sr_1_90",
_23
"IsVisible": true,
_23
"Description": "The Nike Zoom Stefan Janoski Men's Shoe is made with a premium leather upper for superior durability and a flexible midsole for all-day comfort. A tacky gum rubber outsole delivers outstanding traction.",
_23
"DescriptionShort": "The Nike Zoom Stefan Janoski is made with a premium leather.",
_23
"ReleaseDate": "2023-01-01T00:00:00",
_23
"KeyWords": "Zoom,Stefan,Janoski",
_23
"Title": "Zoom Stefan Janoski Canvas RM SB Varsity Re",
_23
"IsActive": true,
_23
"TaxCode": "",
_23
"MetaTagDescription": "The Nike Zoom Stefan Janoski Men's Shoe is made with a premium leather upper for superior durability and a flexible midsole for all-day comfort. A tacky gum rubber outsole delivers outstanding traction.",
_23
"SupplierId": 1,
_23
"ShowWithoutStock": true,
_23
"AdWordsRemarketingCode": null,
_23
"LomadeeCampaignCode": null,
_23
"Score": 1
_23
}

Response body example


_23
{
_23
"Id": 42,
_23
"Name": "Zoom Stefan Janoski Canvas RM SB Varsity Red",
_23
"DepartmentId": 2000089,
_23
"CategoryId": 2000090,
_23
"BrandId": 12121219,
_23
"LinkId": "stefan-janoski-canvas-varsity-red",
_23
"RefId": "sr_1_90",
_23
"IsVisible": true,
_23
"Description": "The Nike Zoom Stefan Janoski Men's Shoe is made with a premium leather upper for superior durability and a flexible midsole for all-day comfort. A tacky gum rubber outsole delivers outstanding traction.",
_23
"DescriptionShort": "The Nike Zoom Stefan Janoski is made with a premium leather.",
_23
"ReleaseDate": "2023-01-01T00:00:00",
_23
"KeyWords": "Zoom,Stefan,Janoski",
_23
"Title": "Zoom Stefan Janoski Canvas RM SB Varsity Red",
_23
"IsActive": true,
_23
"TaxCode": "",
_23
"MetaTagDescription": "The Nike Zoom Stefan Janoski Men's Shoe is made with a premium leather upper for superior durability and a flexible midsole for all-day comfort. A tacky gum rubber outsole delivers outstanding traction.",
_23
"SupplierId": 1,
_23
"ShowWithoutStock": true,
_23
"AdWordsRemarketingCode": null,
_23
"LomadeeCampaignCode": null,
_23
"Score": 1
_23
}

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page