Menu
Feedback
Start here
Tutorials


Adding or editing products
5 min read

The Products and SKUs page allows merchants to manage existing products and variations or add new ones. This article describes how to add or edit products. For information on SKUs, see Adding or editing SKUs.

Registering products can also be done by importing a spreadsheet or via ERP, following the Back office integration guide (ERP/PIM/WMS) instructions on our Developer Portal.

To add a new product to the store catalog, follow these steps:

  1. In the VTEX Admin, go to Catalog > Products and SKUs, or type Products and SKUs in the search bar at the top of the page.

  2. Click + Add product.

  3. In the Product tab, complete the fields in the Default step, as described in the following sections:

    Required fields are marked with an asterisk (*).

  4. Depending on the product category, the Category attributes step might appear with additional sections. Complete the fields as described in Category attributes.

  5. Click Save.

You can deactivate a product after creating it, but you can't delete a single product. The platform only allows bulk deleting products and SKUs in bulk via Full Cleanup.

If the product you created doesn't show in the storefront, check the article Why is the product not visible on the website? to learn how to solve the problem.

See the following sections to learn how to complete the product creation fields.

Basic information

The fields in this section provide general product details:

  • Product name*: Enter the product name to be displayed to customers during their browsing experience. The limit is 150 characters. This field is crucial for SEO, so we recommend the following:
    • ✅ Use simple words
    • ❌ Avoid other languages
    • ❌ Avoid complex spelling
  • Active: To activate the product, enable the toggle Active. To keep it inactive, leave the toggle switch disabled. Learn more about product statuses in the article Products and SKUs.
  • Description: Enter general product information in the text box. This content is displayed to customers in the storefront, so we recommend creating a simple and clear summary.
  • Additional description: When you activate the toggle switch Additional description, a text box displays for including additional product information, such as a summary.
  • Brand*: Type or search for the product brand name and select the desired option. Make sure the brand exists and is active.
  • Category*: Type or search for the product category name and select the desired option, preferably the most specific category level. Make sure the category exists and is active.
  • Trade policies: Choose whether the product should be linked to "All trade policies" or "Specific trade policies". The second option is selected by default, but you must assign one or more values to the field.

SEO

The SEO (Search Engine Optimization) section focuses on optimizing your website to stand out in search results on Google, Bing, and other search engines.

  • Global category: Enter the product's global category, which refers to the taxonomy created by Google for the Merchant Center. This is predefined as a unique tree in the VTEX platform.

  • Product URL: Enter the product URL. The link can't contain spaces and words must be separated by hyphens (-). If you don't enter a value, the platform automatically generates a URL. Learn more in the article How to define the URL for a product page?.

    When filling in the Product URL, avoid using the following reserved words, as this can hinder your store's performance and interfere with the functioning of VTEX Admin pages: a, meta, api and admin.

  • Page title: Enter a name that will be displayed both on the product detail page (PDP) and in the browser tab. This field is crucial for SEO. Avoid using more than 60 characters.

  • Meta description: Provide a brief description of the category, preferably under 160 characters. This allows search engines to display the description correctly on results pages.

As you complete these fields, Google will show a preview of the structure to be displayed on the website.

Storefront

These fields define how the product displays in the storefront:

  • Display on website: If you want to make the product visible in the storefront, enable the toggle switch . To hide it, keep it disabled .

  • Show when out of stock: If you want the out-of-stock product to be displayed on the storefront, enable the toggle switch . This allows customers to use the Notify me feature, which allows them to enter their email and receive a notification when the product is available. To hide out-of-stock items, keep it disabled .

  • Release date: Set a date to make the product available for sale. This field helps sort search results on the website. You can use the query string O=OrderByReleaseDateDESC to retrieve this value and display products in order of release date. In addition, the value of this field influences the creation of automatic collections and determines the product indexing date.

  • Substitute words: Include synonyms for department and/or product category names by typing the desired term and pressing Enter. This field helps make product searches more comprehensive, allowing you to add multiple words up to a limit of 8,000 characters.

    Example: For the product "Sneakers", substitute words could be "Trainers", "Running shoes", and "Athletic shoes".

  • Similar categories: Add the names of similar categories.

  • Priority in search order: Click the arrows to assign a priority level to the product on the search results page. Negative values aren't allowed. For more information, see the article How does the Score field work?.

Identifiers

This section includes product identification codes:

  • Reference code: Unique reference code created to help merchants with catalog management. This is used internally by the store. To complete this field, use a unique combination of letters and/or numbers.
  • Tax code: A numerical sequence that identifies the product.

Category attributes

Depending on the product category, the Category attributes may be displayed below the Default fields. This step includes informational fields that assign characteristics to the product, known as product specifications.

The table below shows examples of product specifications for products in different categories:

CategoryProductSpecificationValue
ClothesShirtFabricCotton
ElectronicsCell phoneBattery duration12 hours
BeveragesWineCountry of originChile

You can create a product without completing required specification fields; however, all required product fields must be completed to activate the product.

Learn more

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Products and SKUs
« Previous
Adding or editing SKUs
Next »
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback