On the New product page, you can create products and their SKUs quickly and simply in Seller Portal. To access it on VTEX Admin, go to Catalog > Products and click on the Create product
button.
To create an active product, you need to keep the Active option selected in the upper right corner of the page. If you want to create an inactive product, click the button and note that the option will change to Inactive. You can activate it later via the product edit page or the product list.
The form to add a new product contains the following sections:
- Basic information
- Operations and Logistics
- Description
- Images
- Attributes
- SKU information
- Specifications
- Variations
- SEO
- Storefront
Before creating a product, you must create the corresponding Category for the product, if it has not been previously registered in your store.
Basic information
Fill in some basic information to start selling your product.
- Product name: write the name of the product. Use simple words, write in the language of your end customer and avoid complex sentences. This field is important for SEO and must not exceed the 150-character limit.This is a required field.
- Brand: select a brand previously added to your store or create a new brand or create a new one by typing the brand name. This is a required field.
- Category: select the category or subcategory related to the product from a tree with the ones already listed in your store. This is a required field.
- Reference code: enter a unique reference code to help with the organization of your store.
Operations and logistics
In this section, you need to add at least one trade policy to apply to the product. You can also select a transportation strategy for it.
- Trade Policies: select the trade policies you want to link with the product, to define on which marketplaces it will be available. This is a required field.
- Modal: select the product's transportation strategy.
Description
In this step, you must write a description with the main information related to the product. The text should contain a clear and simple product description. This is a rich text editor, which means that you can use several formatting features using the toolbar, as illustrated below.

Here are the features available:
- Styles: define the style of the text. The options are Normal and Titles 1 to 6.
- Font size: change the font size. You can choose a value from 10 to 36.
- Bold: format the text in bold.
- Italic: format the text in italics.
- Underline: underline the selected text.
- Left align: align the selection to the left.
- Center align: center the text.
- Right align: align the text to the right.
- Bulleted list: convert the selection to a bulleted list.
- Numbered list: convert the selection to a numbered list.
- Insert link: insert a link in the selected text. Fill in the information below and click
Save
.- Text: edit the text that will contain the link.
- URL: the web page the link will point to.
- Open in a new tab: select it if you want the user to open the link in a new browser tab.
- Source code: displays the source code for the description you have written, in HTML. You can edit the description directly in the source code. To switch back to the previous view, click the source code button again.
Images
To add images to the product, follow the instructions below:
- Click on the
Add images
button or drop the images within the dotted line frame. - Insert all product images, including their variations, such as color and size. Images must be in JPEG, PNG, or GIF format, up to 5 MB each.
We recommend using images of at least 600 x 600 pixels, to ensure that they will be displayed properly in your store.
To rearrange the images and change their display order on the product page, you can click on an image and then drag and drop it to a certain position, as shown below.

You can change information by clicking the button in the row of each image, which opens a menu with the following options:
- Edit description: change the description (Alt text) of the image. This information helps the visually impaired to interpret the images and is also relevant for SEO. After editing the description, save the changes.
- Delete: delete the image. It will be removed from the product and all variations it is associated with. This is a permanent action and cannot be undone. You need to confirm the operation by clicking on the
Delete
button.
Attributes
Attributes are complementary and optional information about your product. For example, a perfume’s attribute might indicate that its application type is spray.
To add a new attribute, click on + Add
and fill in the following fields:
- Attribute name: enter the name of the attribute. For example, "application type".
- Content: enter the value of the attribute. For example, "spray".
To add more attributes, click on Add Attribute
and fill in the required fields.
In the Attributes dashboard, you can view the List of Attributes, which is a group of one or more attributes. By default, when you create the first attribute, it is associated with this group. However, if you wish, you can rename this group and add or delete other attribute groups. Here are the possible actions:
- button:
- Rename: rename the attribute group.
- Delete: delete the attribute group and all attributes in it.
- + Add group: add a new attribute group.
For example, a cosmetic store could configure attribute groups of a perfume as shown below.
-
Group 1 - Scent
- Olfactive family: floral, citrus
- Intensity: moderate
-
Group 2 - Use
- Fixation time: long
- Application type: spray

After you have made the desired changes in the attribute dashboard, save the information.
To edit an attribute, select it from the list. To delete an attribute, click the icon. If you delete an attribute from a group that only has one listed attribute, the group will also be removed.
SKU information
Each product must have at least one SKU added. If your product has no variations and you want to create only one SKU associated with it, fill in the information below:
- SKU Reference code: unique reference code created to improve the store's organization. This is not a required field.
- EAN/UPC: unique SKU identification code (barcode), composed of up to 13 numeric characters.
- Package dimensions:
- Weight: the field to enter the weight of the package, in kilograms. This is a required field.
- Width: the field to enter the width of the package, in centimeters. This is a required field.
- Height: the field to enter the height of the package, in centimeters. This is a required field.
- Length: the field to enter the length of the package, in centimeters. This is a required field.
If you want to create more than one SKU according to your product's variations, click on the + Add variations
button.
Clicking on
+ Add variations
will delete the data you have entered in the SKU information fields.
What differentiates one SKU or product variation from another is the many possible combinations of specifications. For example, you add a pair of sneakers and configure its color specification with the pink and blue options and its size specification with the sizes 7 and 8. This product's SKUs will be the combinations of the previous options: pink sneakers size 7, pink sneakers size 8, blue sneakers size 7, and blue sneakers size 8.
Specifications are prerequisites for distinguishing SKUs, so clicking on the + Add variations
button will open a modal window where you can create specifications.
Creating specifications
To create a product specification, you must fill in the following information:
- Specification name: write the name of the specification you want to create. For example, color and size.
- Options: define the possible options related to this specification. For example, pink. In this field, you must enter the options you want to include and type the option name, press
enter
or click on Create “option name” + to proceed and create other options.
If you want to create more specifications, click on the + Add specification
button and fill in the new fields.
After configuring the specifications, click on the Create
button.
The specifications you’ve created and their respective options will be listed in the Specifications section and can be edited later.
By combining these different options, the system automatically generates a list of SKUs and displays it in the Variations section.

Specifications
In this section, you can find the specifications you’ve created and the options associated with them.
You can edit the specification info by clicking on the button on each row.
Once you have configured product specifications, you cannot delete a specification or add a new one. While editing, you can only add new values to the existing specification.
You can also click on the + Add specifications
button to include more specifications.
When you edit, delete, or add specifications on this page, the system automatically updates product variations according to the new configuration.
Variations
In this section, you can see a list of all product variations (SKUs) automatically generated from the specifications and options you have created.
To fill in the information for each variation, click on the arrow (>) or the row of the variation you want to edit. The fields included in the SKU information section will be displayed for each variation you have created.
By clicking the arrow (>), you can view and edit the Variation Name and other information corresponding to the variation. By clicking the Advanced Editing
button, you can access the product variations advanced editing dashboard.
By clicking on the button, you can perform the following actions:
- Edit: change the variation information in the Advanced editing window.
- Edit images: access the image editing dashboard, which opens the actions listed below. After you have made the desired changes, click on
Save
.- Select images: select images corresponding to the variation. To select an image, just click on it. If you want to select all images at once, use the keyboard shortcut
Ctrl
+A
. - Apply to multiple variations: you can add the selected images to multiple variations. To do so, click on
Apply to multiple variations +
and select the values of the specifications your image relates to. For example, for an image of beige sneakers, you should select thebeige
option from thecolor
specification. The image will then apply to all variations whosecolor
specification has the valuebeige
, regardless of any other specifications you have set.
- Select images: select images corresponding to the variation. To select an image, just click on it. If you want to select all images at once, use the keyboard shortcut

- Add images: on this page, you can also upload new images by clicking on the
Add images
button or by dropping image files into the dotted space. - Deactivate: deactivate the SKU.
If you add specifications after configuring the variations, the system will recalculate all variations and redefine their fields.
Advanced Editing
You can view and edit all information and images related to each product variation in the variations advanced editing dashboard, illustrated below.

In the Variations section on the left side of the dashboard, you will find the list of variations of your product. To edit a specific variation, click on it.
To make the selected variation available in your store, keep the Active option selected in the upper right corner of the page. If you want to disable the variation, click the button and the option will change to Inactive.
Bulk edit
To edit a large number of variations at once, you can use the Bulk edit feature by following the steps below.
- Click on the
Bulk editing
button to open the variation editing spreadsheet. - To edit information, double-click on the field you want to change.
You can edit the following information:
- Active: whether the variation is active or not.
- Name: name of the variation.
- Reference code: unique reference code created to improve store organization.
- Manufacturer code: manufacturer code for the variation.
- EAN/UPC: unique SKU identification code (barcode). Supports up to 13 numeric characters.
- Weight: the weight of the package, in kilograms.
- Width: the width of the package, in centimeters.
- Height: the height of the package, in centimeters.
- Length: the length of the package, in centimeters.
To filter the columns displayed in the spreadsheet, click on Filter columns
and select the columns you want to hide.
You can replicate information from one cell to other rows and columns. To do this, click on the blue square in the lower right corner of the cell and drag to the cells where you want to automatically replicate the value, as shown in the image below.

- After editing, click on
Apply
to save the changes.
SEO
The way you fill in the fields in this section affects how the product will be ranked in search engines, such as Google.
- Product URL: customize the URL by which the product can be accessed in your store. Do not use spaces or special characters in this field. If the URL has more than one word, separate them with a
-
. This is a required field. - Page title: write the title of the product page. To optimize your product's ranking in search results, it should not exceed 60 characters. This is a required field.
- Meta description: write the product description that will be displayed in search engines. Google only shows the first 160 characters of this description.
By filling out the SEO fields, a preview of your product in Google's results will be displayed. See an example in the image below.

Storefront
In this section you can configure whether the product will appear in your store through the following options:
- Visibility
- Show on site: toggle button to enable or disable the product display on the store. If the product is a giveaway that cannot be purchased, you must disable this option.
- Show when out of stock: toggle button to enable this function. If this function is enabled, the out-of-stock product will appear in your store with a Notify Me option, in which customers enter their email to be notified when the product is back in stock. If this function is disabled, the out-of-stock product will not be displayed in the store.