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 SKUs. For information on products, see Adding or editing products.

Every new SKU must be linked to a product. Once the product is created, follow the steps below to add a new SKU:

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 the row of the desired product.
3. Click the SKUs tab.
4. Click the add icon + to open the options to add SKUs.
5. Click Add new SKU.

You can create a new SKU from an existing one within a product. To do this, on the SKUs tab, click the SKU menu icon > Duplicate > Save.

6. Complete the fields on the SKU form as described in the sections:

   • Name and status

   • Specifications

   • Media

   • Identifiers

   • Logistics

   • Commercial strategy

   • Customizations

   • Cross-sells and up-sells

   Required fields are marked with an asterisk (*).

7. Click Save.

You can deactivate a SKU after creating it, but you can't delete a single SKU. The platform only allows bulk deletion of products and SKUs via Database Maintenance (Full Cleanup).

After creating the SKU, you can track its availability for sale through the colored icon. Hovering over the icon displays a tooltip with the meaning of the color, as in the image below. Learn more in Products and SKUs.

Additionally, once the SKU is created, you can include it in a bundle. To do so, in the row of the desired SKU, click the menu icon and select the Create bundle option. Note that converting a SKU into a bundle can't be undone.

See the following sections for details about the form fields and instructions on how to complete them.

There is a limit of 50 SKUs per product. To request an extension of the limit, please contact our Support.

The first section of the form includes the name and status of the SKU:

• Name*: Enter the SKU name, which identifies the product variation. The name is limited to 200 characters. Example: For the product "Refrigerator", the SKU name could be "28.6-Cu".
• Active: To activate the SKU, enable the toggle switch . To keep it inactive, leave the toggle switch disabled. If the SKU remains unavailable for sale after activation, check the article Why is the product not visible on the website?.

Specifications are properties configured in the SKU that customers can select before adding the product to the cart. For example, the capacity of an appliance is a specification, allowing customers to choose between 25 cu ft or 21.4 cu ft.

The Specifications section may display different fields depending on the product associated with the SKU.

If a SKU has specifications, they must be completed. For more information, see the article Adding SKU specifications or fields.

It's not possible to create a SKU with the same values combination​ as another SKU. For example, if the combination of SKU A is color black and size S, it would not be possible to create SKU B with the color black and size S, as this would generate a conflict. However, if the SKU A was black and the SKU B color was blue, even if you kept the size S for both, there would be no conflict as the combinations would differ. It is worth mentioning that you can deactivate but not delete a single SKU.

In this section, you can add images or videos to the SKU.

In the Images field, clicking Add displays two options for uploading photos and images:

• Choose files: Upload images stored locally on your computer or another device.
• Add links: Upload images using a URL.

The table below shows the size limits and formats accepted for each image:

File size and format	Description
Maximum size in pixels	5,000 x 5,000 pixels
Minimum size in pixels	600 x 600 pixels
Maximum size in MB	4 MB
Minimum size in KB	300 KB
Allowed file extensions	JPGPNGGIFICOSVGWEBP

|

For more recommendations, check the article Best practices for using images in the Catalog.

After uploading an image, you can edit its metadata by following the steps below:

1. Hover over the image to view the existing icons.
2. Click the menu icon .
3. Click Edit metadata.
4. In the modal, complete the metadata information.
5. Click Apply.

In addition to adding new images to an SKU, you can replicate images from one SKU to other SKUs associated with the same product. To do so, follow the steps below:

1. In the top right corner of the Images section, click the copy icon .
2. In the Select the SKUs where you want to replicate the media modal, click the SKUs to which you want to copy the images.
3. Click Apply.

A SKU must have at least one image to be activated. For more information on the conditions for displaying an item on the storefront, see the article Why is the product not visible on the website?.

In the Videos field, click + Add to open the Add SKU media links window. To add a video, enter its URL and then click Apply.

A SKU can have up to 6 videos, and you can only add them using links from either the Vimeo or YouTube platforms**. The accepted formats are:

Vimeo

• https://vimeo.com/{VIDEO_ID}

YouTube

• https://youtu.be/{VIDEO_ID}
• https://www.youtube.com/watch?v={VIDEO_ID}
• https://www.youtube.com/embed/{VIDEO_ID}
• https://www.youtube.com/v/{VIDEO_ID}

The fields in this section refer to the codes that identify the SKU:

• Reference code: Unique reference code created to help merchants with catalog management.
• EAN/UPC: The EAN (European Article Number) and the UPC (Universal Product Code) are in ternational identification codes corresponding to an item's barcode. Each SKU can be associated with only one of these codes, and they can be differentiated by the number of alphanumeric characters: 13 for the EAN and 12 for the UPC.
• Manufacturer code: Code provided by the manufacturer to identify the SKU. If a SKU has a specific code, this field must be completed.

These are the SKU fields related to logistics:

Modal is a carrier configuration for specialized deliveries, as some products require special transport conditions, such as refrigeration or the ability to carry chemical cargo.

When previously created, modal options for the SKU will be displayed in a list, allowing you to select a single option. To learn more, see the article Setting up modal for carriers.

The following fields are used to calculate the cubic weight factor of the SKU and refer to the package used for its transportation:

• Package weight: Absolute weight value.
• Package width: Absolute width value.
• Package height: Absolute height value.
• Package length: Absolute length value.

Fields should only be completed with numbers, without units of measure, as they automatically apply the units configured in the store catalog.

The fields below correspond to the actual dimensions of the product — the same that are displayed on the product detail page (PDP) — and should be completed with numbers only:

• Actual weight: Absolute product weight value, excluding packaging.
• Actual width: Absolute product width value, excluding packaging.
• Actual height: Absolute product height value, excluding packaging.
• Actual length: Absolute product length value, excluding packaging.

The following fields define how the SKU will be organized and counted in the warehouse:

• Unit of measure: Identifies the unit of measure used to count items in stock.
• Unit multiplier: Numeric value by which the SKU will be multiplied to determine its quantity in the cart. For example, a multiplier of 5 means that each SKU represents 5 units in the cart, allowing purchases only in multiples of 5, such as 10 or 15 units. Fractional values can be separated by either a period or a comma. For example, 0.5 or 0,5 for half a kilogram.

The value in the unit multiplier field has no impact on inventory and logistics calculations.

This section includes fields related to the store's sales strategies:

• Commercial condition: Defines the promotions or payment conditions that are valid for the SKU. If no commercial condition is needed, select the Default option. Learn more in Registering a commercial condition.
• Presale date: Sets a presale date for the SKU, indicating when the item is expected to arrive in stores and be available for sale. To configure this setting, you need to consider both the item release date and the estimated shipping to customers.
• Generate credit with gift card: When enabled, specifies that the sale of the SKU will generate a gift card credit to the customer.
• Loyalty amount: Determines the credit the customer receives when purchasing 1 unit of a given SKU. For example, if this field is set to $1.00, the customer who buys the SKU will receive a $1.00 store credit for future purchases.

SKUs can be configured to offer customization options to customers. For example, a customer can add a name to a t-shirt. There are two types of customizations: attachments and services.

To link a customization to a SKU, click the add + icon, select the desired option, and follow these steps:

• Attachments: Clicking this option opens the Choose the attachments you want to link modal. Select the desired attachments and click Apply.
• Services: Clicking this option opens the New service modal. Complete the fields and set the toggle switch to Active. Click Apply to save the information.

The attachment and service options for the SKU must be configured in advance. For more information, see the articles Adding an attachment and Creating a service for a SKU.

This section allows the store to configure cross-selling and up-selling options for the new SKU, reflecting them on the storefront and in the customer browsing experience.

Below are the possible types of items you can associate with the SKU.

• Accessories: Complimentary items suggested for the main product.
• Suggestions: Product recommendations.
• Similar products: Alternatives to the selected item or products with similar characteristics.
• Show together: Suggestions for buying together.

To configure any of the above options, follow the steps below:

1. In the Cross-sells and up-sells section, click the add icon +.

2. Click one of these options

   • Accessories
   • Suggestions
   • Similar products
   • Show together

3. In the text field of the open modal, enter the SKU ID of the desired item.

4. Click Apply.

For more information, see the article How to set up similar product, suggestions, accessories and generics.

• Products and SKUs
• Adding or editing products
• Catalog: Overview
• Catalog (track)