Mercado Libre Image Requirements: Sizes, Limits, Charts

Mercado Libre image requirements have a published floor of 500 × 500 px, and that number is a trap. An image at exactly 500 px uploads cleanly, returns no warning, and quietly ships a listing with no zoom, because zoom only switches on above 800 px wide. Nothing in the API response tells you. The listing just converts worse than the seller next to you and you never find out why.

This is the Mercado Libre image requirements set as the platform's own seller and developer documentation actually specifies it, what it leaves to the category, and where cross-border sellers get blocked.

Mercado Libre image requirements at a glance

Item	Requirement	Source
Minimum accepted size	500 × 500 px (the "M" version)	Working with pictures
Maximum accepted size	1,920 × 1,920 px (the "F" version)	Working with pictures
Larger uploads	Resized down to the F version automatically	Working with pictures
Smaller uploads	Kept as-is — the platform will not enlarge them	Working with pictures
Zoom activation	Pictures wider than 800 px activate the zoom widget on rollover	Working with pictures
File size limit	Up to 10 MB per picture	Working with pictures
Formats	JPG, JPEG, PNG	Working with pictures
Colour space	RGB strongly preferred over CMYK	Working with pictures
Picture count per item	Capped per category, not globally	Working with pictures / CBT FAQ
Variation pictures	Count toward the same category cap	CBT images FAQ
Pre-upload validation	A smartcrop validation endpoint checks size and trims excess background	Working with pictures

The practical reading: shoot and export a square image between 1,200 and 1,920 px on the long side, in RGB JPG, under 10 MB. That sits above the zoom threshold, below the resize ceiling, and inside every format rule at once.

The Mercado Libre image requirements line that decides whether buyers can zoom: 800 px

Mercado Libre's developer documentation states it plainly: for pictures wider than 800 pixels, a zoom widget is activated so buyers can roll over and take a close-up look, and it flags this as highly recommended for clothing.

That single sentence carries more revenue than the rest of the spec sheet. Zoom is how a buyer checks a seam, a finish, a printed dimension, or a texture without asking a question. A listing without zoom pushes every one of those checks into the questions box — or into a purchase the buyer intends to return.

The distinction that matters:

500 px is what the platform will accept.
800 px is what the platform needs before the buyer gets a magnifier.
1,920 px is the ceiling, past which your file is resized anyway.

Shooting to 500 px because that is "the requirement" is the single most common self-inflicted wound in this marketplace. There is no penalty message, no listing-quality flag pointing at it, no rejection. The feature simply never appears.

The picture limit is per category, and your variations count against it

This is where cross-border sellers get errors they cannot reproduce.

The maximum number of images per item is set by category, not by a single platform-wide number. And per Mercado Libre's own cross-border trade FAQ, images are counted from variations as well as from the root pictures array — so if you set images in both places, the effective total can exceed the category limit even though the gallery you uploaded looks small. The error reads like "Items in category … cannot exceed X pictures" and it looks like a bug. It is not.

Three failure modes documented by the platform:

Symptom	Actual cause	Fix
"Cannot exceed X pictures" when you uploaded fewer	Root pictures plus every variation's pictures are summed	Count total effective images before publishing; put images only where they are needed
A previously fine listing starts failing updates	The category's image limit was reduced	Re-validate active listings against current category constraints; reduce the gallery, or split a many-variant product into multiple listings
An image-limit error on a variation update that changed no images	A partial variations update implicitly removed other variations, so constraints were recalculated on the new structure	Treat variation updates as full replacements: read current variations, modify in memory, PUT the complete array back

The operational rule: build a "total effective images" counter into your publishing process and enforce the strictest category maximum before you call the API. Marketplace-by-marketplace differences like this are why one export set rarely survives everywhere — the same pattern shows up in Temu product image requirements.

Not rejected, just downgraded: how listing quality reads your photos

Mercado Libre scores listing quality and exposes it to sellers. The older /health API is being retired in favour of /performance, which returns a score, a level, and the specific actions still pending.

Levels differ by site: on CBT they read Basic, Standard and Professional; on the Argentine site Básica, Estándar and Profesional; on the Brazilian site Básica, Satisfatória and Profissional.

Photos are their own bucket in that score, and one of the rules inside it is a minimum picture quantity check — a listing carrying too few images is marked pending with a prompt to add more, phrased as improving photos to get more visits. So an image gallery that is technically valid can still cost you exposure. Compliance is the floor; the score is the thing that ranks you.

Size charts: the requirement most exporters discover late

For fashion domains, Mercado Libre treats the size chart as a structured object, not a picture of a table. That distinction catches sellers who have always shipped a JPEG sizing chart as image number five.

What the documentation requires:

A chart is either SPECIFIC (created by the seller) or BRAND (pre-established by brand).
The chart is attached to the item through a SIZE_GRID_ID attribute, and each variation must carry a SIZE_GRID_ROW_ID pointing at its row. A chart cannot be associated without a row id.
The chart name must be unique and is capped at 60 characters, and it is reused across sites rather than translated per site.
The chart's gender must match the item's gender.
The user who creates the item must be the same user who created the chart.
Item creation for these domains also requires package dimensions — PACKAGE_WEIGHT, PACKAGE_LENGTH, PACKAGE_WIDTH, PACKAGE_HEIGHT — alongside title (max 60 characters), category, price, condition, pictures and sale terms.

The stated purpose is blunt and worth repeating to anyone who thinks this is bureaucracy: the size chart exists so buyers choose correctly and you avoid exchanges and claims. A structured chart is machine-readable, filterable, and shown at the point of choice; an image of a chart is none of those things.

If your charts are still in centimetres-only or US-only, the conversion traps are laid out in international size conversion charts — and what wrong sizes cost you per order is what the return cost calculator is for.

Common causes of blocked or weak listings

Cause	What happens	Prevention
Image exactly 500 px	Accepted, no zoom, no warning	Export at 1,200–1,920 px
Image above 1,920 px	Silently resized	Export at the ceiling, not above it
CMYK file	Colour shifts on the marketplace	Convert to RGB before export
File over 10 MB	Upload rejected	Compress; JPG quality 80–90 is enough at these sizes
Root + variation images summed	Category limit error	Count effective total before publishing
Partial variation update	Implicit deletion, recalculated limits, error	Always PUT the full variations array
Size chart as a JPEG	No structured sizing, more exchanges	Create a SPECIFIC or BRAND chart and map every variation row
Too few pictures	Listing quality drops, exposure drops	Check the pictures bucket in `/performance`

What to fix first

If you are auditing an existing catalog rather than starting clean, do it in this order — the first item pays for the rest.

Re-export everything above 800 px. One batch operation, immediate effect on zoom across the whole catalog.
Run a total-effective-image count on every active listing and compare it against the current category cap. Fix the ones that are one update away from failing.
Convert JPEG sizing charts into structured size charts for every fashion domain listing.
Add one dimension image per SKU. Not a size chart — an image of the product with its measured width, depth, height and, where it matters, package dimensions drawn on the product itself. This is the image that answers the question buyers would otherwise ask, and it is the one most catalogs are missing entirely.

For that fourth item there are three realistic routes. You can brief a designer per SKU, which is accurate and does not scale. You can draw arrows by hand in a general photo editor, which breaks the moment the image is re-exported at a different size and leaves labels pointing at nothing. Or you can use software built for it — one that snaps a dimension line to the real edge of the product in the photo, keeps the measured value locked to that line through every resize, and exports the same annotated image at each marketplace's required dimensions. The difference against an AI image generator matters here: a generator will produce a confident-looking number that was never measured, and on a marketplace that is a returns liability rather than a shortcut. If dimension images are going into quotations and catalogs as well as listings, the reusable layout is covered in the spec sheet guide.

Pre-upload checklist for a Mercado Libre listing

Every image between 1,200 and 1,920 px on the long side
RGB colour space confirmed, not CMYK
Each file under 10 MB, JPG/JPEG/PNG only
Root pictures plus all variation pictures counted and under the category cap
Variation updates sent as a complete array, never partial
Category-specific photo rules checked in that category's own help article
Structured size chart created and every variation mapped to a row
Chart gender matches item gender; chart created by the same user publishing the item
Package weight and package length, width and height filled in
Title within 60 characters
At least one image carries measured product dimensions
Listing quality checked through /performance after publishing, not before

FAQ

What size should Mercado Libre product photos be?

Between 1,200 and 1,920 px on the long side. The documented minimum is 500 × 500 px and the maximum accepted is 1,920 × 1,920 px, but images must be wider than 800 px for the zoom widget to activate, and anything above 1,920 px is resized down anyway. Square format, RGB, under 10 MB.

How many photos can I upload to a Mercado Libre listing?

There is no single number — the maximum is set per category. Check the cap for your category, and remember that any pictures attached to variations are counted against the same limit as the pictures in your main gallery.

Why does Mercado Libre say my listing exceeds the picture limit when I only uploaded four images?

Because variation images count too. If you set pictures in the root array and also inside each variation, the effective total is the sum. A product with four gallery images and six variations each carrying two images is submitting sixteen, not four.

Does Mercado Libre require a size chart?

For fashion domains, yes, and it must be a structured chart rather than an image. It is attached with a SIZE_GRID_ID on the item, each variation needs a SIZE_GRID_ROW_ID, the chart's gender must match the item's, and the chart has to have been created by the same user who publishes the item.

Can I reuse the images I already use on other marketplaces?

The photography usually transfers; the export settings rarely do. Every marketplace sets its own minimum, maximum, zoom threshold, file-size cap and per-category count, so the safe approach is one high-quality master per shot and a per-destination export preset — not one folder of files pushed everywhere.

Mercado Libre Image Requirements: 800 px Is the Real Floor