SKUs and variants: how to link Mercado Libre with Shopify
How to prepare SKUs, variants and barcodes to link Mercado Libre with Shopify: duplicates, GTINs, User Products, kits and how to audit your catalog first.
In short
To link your Mercado Libre listings with Shopify without errors, give each variant a unique SKU, the same on both channels, and use valid barcodes (GTINs) as a backup. A duplicate or missing SKU leaves any tool unable to tell which listing belongs to which product. Review your catalog before you connect anything, with Shopify's CSV export and Mercado Libre's Excel spreadsheet, and keep in mind that the move to User Products creates new listings with new IDs.
Before syncing stock, prices or orders, a tool has to know which Mercado Libre listing belongs to which Shopify variant. That link is almost always made by SKU or barcode. If it fails, one product's stock ends up on another product's listing.
This guide explains the rules of a clean catalog, what changes with variations and User Products, what to do with several listings for one variant and with kits, and how to review your SKUs before you connect any tool. To learn what stock each listing should get once it's linked, read how to sync inventory between Shopify and Mercado Libre.
Why everything starts with the SKU
The SKU is your internal code for each variant. Mercado Libre Mexico describes it like this: an internal code that isn't registered universally and that you don't need to fill in to publish. To link your channels, on the other hand, it's the foundation.
It works because you decide it: the red T-shirt in size M is "PLA-ROJ-M" in Shopify and on Mercado Libre. With that, any tool finds the match without guessing.
On Mercado Libre, the SKU goes in the listing's SKU attribute and, if it has variations, in each variation's. According to the developer documentation, that value shows up both on the listing and on its sales.
The barcode (GTIN, the Global Trade Item Number) is the backup: it identifies the product worldwide and helps when a listing has no SKU.
When the link fails, the error spreads: one variant's stock is sent to another variant's listing, and a Mercado Libre sale reaches Shopify with the wrong product.
Rules for a clean catalog
One unique SKU per variant, the same on both channels
Each Shopify variant needs its own SKU, and its Mercado Libre listing (or variation) needs the same one. Shopify's help asks for the same thing: two variants shouldn't have the same SKU, because duplicates cause problems with third-party integrations and inventory tracking. Shopify warns you when it detects one, but it lets you save it.
The same help gives format tips: short SKUs (for example, 16 characters or fewer), without special characters, symbols or spaces, and without combinations that confuse 0 with O or 1 with I.
Valid barcodes
If you use barcodes, make them real GTINs. According to Mercado Libre Mexico, a product's universal code is numeric, has 8 to 14 digits, is registered with GS1 and is usually an EAN or a UPC; it isn't an internal code like the SKU, nor a distribution code. If you sell a product in several colors or materials, each variant gets its own code.
GS1, where these codes are registered, describes their formats: GTIN-13 (the most common), GTIN-12 (used in the United States and Canada), GTIN-8 for very small products and GTIN-14 for cases holding several products. The last digit is a check digit, and in databases a GTIN-13 is stored as 14 digits, with a leading 0. That's why the same code can show up with a different number of digits.
Mercado Libre validates these codes: according to its developer documentation, it won't let you publish with a GTIN that isn't valid, and it accepts the same code padded with leading zeros. In some categories, if your product has no code, you can give the reason: handmade (artesanal), kit, not registered or other.
Don't make up codes or reuse one across variants: each GTIN belongs to a single product.
What happens with duplicate or missing SKUs
A tool that finds two variants with the same SKU has two options: guess or not link. Guessing is worse, because if it's wrong it sends one product's stock to another. The right thing is to flag the conflict and ask you to choose.
A listing without a SKU depends on its barcode. If it has none either, it stays unlinked: it gets no stock, and its sales don't know which variant to subtract.
Duplicates also matter on Mercado Libre's side. In its FAQ for accounts with several warehouses, the documentation mentions conflicts when creating listings if a SKU or GTIN is already associated with another product, and recommends keeping them unique.
Watch out for invisible differences too: "ABC-01" and "abc-01 " look like the same SKU, but not every tool treats them the same way.
Variations and User Products
Mercado Libre is changing how it organizes variants, and that affects your links.
The older model: one listing with variations. A single listing groups, for example, sizes and colors, with stock per variation. According to the documentation, each variation can carry its SKU, they all share the same price, and you can't have different shipping methods or promotions per variant.
The new model: User Products. Each variant is its own product, and that product can be in one or several listings, each with its own sales conditions. In this model you no longer publish with variations.
The migration. According to the documentation, when your account moves to the new model, listings without variations migrate on their own. When a listing with variations is migrated, Mercado Libre creates a new listing for each variation, with new IDs, and the old one is closed. Earlier sales stay tied to the old listing.
For your links, this decides everything. If each variation had its own SKU, the new listings get linked again by SKU. If your tool relied on the listing ID, or if the variations shared a SKU, the links are lost.
Several listings for one variant
It's normal to sell the same variant in more than one listing, for example a Clásica and a Premium listing (two of Mercado Libre's listing types). According to Mercado Libre's documentation, one product can have up to 30 listings with different sales conditions, and when you publish one that Mercado Libre recognizes, it associates it with the product that already exists.
What isn't allowed is duplicate listings. According to Mercado Libre Mexico, they're listings of the same product with the same sales conditions; they aren't allowed, and Mercado Libre keeps active the one with the best visibility.
For your SKUs, the rule is simple: all those listings carry the variant's SKU. A tool should link them all to that variant without treating it as a conflict. The conflict is the other way around: one SKU pointing to two Shopify variants.
With User Products, those listings share stock. If one of them uses Full, that stock is separate: we explain it in Mercado Libre Full and your Shopify stock.
Kits
A kit sells several items together. For your links there are two cases:
- Mercado Libre's virtual kits. According to its documentation, you group 2 to 6 of your products in one listing and Mercado Libre works out the kit's stock from the stock of each component. For example, a kit with one item A and two items B, if you have 4 of each, has a stock of 2. A tool shouldn't write those kits' stock: what gets synced is their components.
- Bundles you put together yourself. If the bundle is a separate product in Shopify, with its own SKU, it has its own inventory, separate from its items'. Decide how you'll manage it and review it before a peak season; we cover that in the peak season checklist.
If a kit doesn't have its own barcode, in the categories that allow it you can give "Kit" as the reason.
How to audit your SKUs before you connect a tool
You don't need any app: a spreadsheet with your two catalogs is enough.
In Shopify: export your products
According to Shopify's help, in your admin go to Products, click Export, choose which products to export (for example, all of them) and the CSV file type. Depending on the case, the file downloads or is emailed to you.
In the file, each product's first row holds its details, and each variant follows on its own row, with the same product identifier (URL handle). Check the SKU column and the barcode column (Barcodes), which can hold several codes separated by semicolons. If you use an older template, the column names may be different.
Look for three things:
- Missing SKUs. Each variant needs one.
- Duplicate SKUs. Sort by SKU or count how many times each one appears.
- Invisible differences. Leading or trailing spaces, mixed upper and lower case, the letter O instead of 0.
On Mercado Libre: download your listings
According to Mercado Libre Mexico, from your listings you can use Modificar desde Excel (edit from Excel): you choose the data and the listings, download the spreadsheet, edit it and upload it again. The data you can change includes the SKU and the stock.
Two precautions: don't change the order or the titles of the columns, and upload it within 30 days, because after that the spreadsheet no longer works. If something fails, Mercado Libre gives you a spreadsheet with the errors so you can fix them.
Compare the two lists
Each Shopify SKU should appear on its variant's listings on Mercado Libre, and each Mercado Libre SKU should exist in Shopify. Anything left over on one side is a listing that won't get linked.
Steps to prepare your SKUs and variants
- Export your products from Shopify. As a CSV, with all your variants.
- Fix missing and duplicate SKUs. One unique SKU per variant.
- Clean up the format. Short, without spaces or special characters, without mixing up O and 0.
- Check your barcodes. Real GTINs, 8 to 14 digits, one per variant and none made up.
- Download your Mercado Libre listings. With Modificar desde Excel, including the SKU.
- Put the same SKU on each listing or variation. Including the Clásica and the Premium listing of one product.
- Decide what to do with kits. For Mercado Libre's kits, their components are synced; your own bundles get their own SKU.
- Review migrated listings. User Products listings have new IDs: confirm each one carries its SKU.
- Connect your tool and review whatever didn't find a match. Fix the SKU before linking by hand.
Frequently asked questions
Are the SKU and the barcode the same thing?
No. The SKU is your internal code; the barcode (GTIN) is universal and registered with GS1. Mercado Libre asks for the GTIN in some categories; the SKU is optional for publishing, but it's the foundation for linking your channels.
Can I use the same SKU on a Clásica and a Premium listing?
Yes, and you should: they're the same product with different sales conditions. The problem is the other way around: the same SKU on two different Shopify variants.
What happens to my links when Mercado Libre migrates a listing to User Products?
The old listing is closed and a new one appears for each variation, with new IDs. If each variation had its SKU, the new ones can be linked again by SKU. Earlier sales stay tied to the old listing.
Do I have to buy barcodes to sell on Mercado Libre?
No, according to Mercado Libre Mexico: if your product doesn't come with a factory code or you make it by hand, you can say the code doesn't apply. What you shouldn't do is make one up.
Does Shopify let me repeat a SKU?
Yes: it shows a warning, but it lets you save it. Its own help recommends against it, because duplicates cause problems with integrations and inventory.
About Toldo
Toldo is a Shopify app we build; it's rolling out in stages with a small group of founding partners. It links each listing (or each variation) to a Shopify variant by looking first for the same SKU, not case-sensitive and ignoring extra spaces, and then for the same barcode (a GTIN with 8, 12, 13 or 14 digits, ignoring leading zeros); if there's more than one possible variant, it doesn't guess: it marks the listing "Several matches" for you to choose, and it shows you the list of repeated SKUs. You can also link by hand with Link to a variant or use Ignore, several listings can point to the same variant, and when Mercado Libre migrates a listing to User Products, Toldo marks the old one as Closed, looks for the new ones for 7 days and carries over your manual links and ignored listings to them (link listings). It charges a flat monthly price, with no per-sale commission. During the rollout, we turn on each feature in stages. If you sell on Mercado Libre and Shopify, you can apply as a founding partner.
Mercado Libre, Shopify, GS1 and Excel are trademarks of their respective owners. Toldo is an independent app; it isn't affiliated with or endorsed by them.
Sources
Accessed on November 16, 2026, unless another date is given.
- Mercado Libre Mexico, everything you need to know about universal product codes: https://www.mercadolibre.com.mx/codigos-universales
- Mercado Libre Developers, product identifiers (updated September 25, 2026): https://developers.mercadolibre.com.ar/en_us/product-identifiers
- Mercado Libre Developers, variations (updated December 21, 2022): https://developers.mercadolibre.com.ar/en_us/variations
- Mercado Libre Developers, User Products (updated December 19, 2025): https://developers.mercadolibre.com.ar/en_us/user-products
- Mercado Libre Developers, price per variation (updated August 13, 2026): https://developers.mercadolibre.com.ar/en_us/price-per-variation
- Mercado Libre Developers, multi-origin stock FAQ (updated May 5, 2026): https://developers.mercadolibre.com.ar/en_us/multi-origin-stock-management-user-products
- Mercado Libre Developers, virtual kits (updated September 17, 2026): https://developers.mercadolibre.com.ar/en_us/virtual-kits
- Mercado Libre Mexico, duplicate listings: https://vendedores.mercadolibre.com.mx/nota/publicaciones-duplicadas-que-son-y-como-evitarlas
- Mercado Libre Mexico, learn to edit listings with Excel: https://vendedores.mercadolibre.com.mx/nota/modifica-tus-publicaciones-desde-excel
- GS1 Sweden, different types of GTINs: https://gs1.se/en/identify/global-trade-item-number-gtin/different-types-of-gtins/
- Shopify Help Center, using SKUs to manage your inventory: https://help.shopify.com/en/manual/products/details/sku
- Shopify Help Center, exporting products: https://help.shopify.com/en/manual/products/import-export/export-products
- Shopify Help Center, product CSV files: https://help.shopify.com/en/manual/products/import-export/using-csv