Shopify limita las imágenes de producto a 20 MB y 20 megapíxeles; la app redimensiona automáticamente las imágenes más grandes. La mayoría de los problemas de emparejamiento vienen de identificadores duplicados, identificadores vacíos o pequeños errores de nombre, y todos se ven en la vista previa antes de subir.
Límites
| Límite | Valor | Qué hace la app |
|---|---|---|
| Tamaño de archivo | 20 MB (Shopify) | Redimensiona y recodifica jpg, jpeg, png, webp, gif. Solo falla con un error claro si aun así no cabe. |
| Resolución | 20 megapíxeles (Shopify) | Reduce a unos 18 MP y vuelve a intentarlo. |
| Imágenes por producto | 250 (Shopify) | Límite propio de Shopify |
| Plan gratuito | 25 imágenes en total | El trabajo se detiene con “Free upload limit reached”. |
| Tablas de la vista previa | 5.000 filas visibles cada una | Los contadores y el CSV lo incluyen todo. |
| Resultados del emparejamiento | Se guardan 2 horas | Vuelve a emparejar si esperas más. |
| Límite de velocidad de archivos de Shopify | Para toda la tienda | Pausa automática (3 s → 6 s → 12 s) y reintento. |
Las imágenes que superan los límites aparecen en un aviso de la vista previa antes de subir.
Especificaciones recomendadas: JPG o WEBP, de 2048 a 4096 px en el lado más largo, sRGB, menos de 5 MB.
Cuánto tardan las subidas grandes
Shopify limita la velocidad a la que pueden cambiar los archivos de una tienda, para toda la tienda. La app descarga y sube en paralelo y reduce el ritmo automáticamente al llegar al límite, así que los trabajos grandes avanzan de forma constante, no rápida. Cuenta con horas, no minutos, para decenas de miles de imágenes. El progreso se guarda por imagen, así que un reinicio continúa donde se quedó.
Problemas de emparejamiento
| Síntoma | Causa probable | Solución |
|---|---|---|
| Ninguna imagen emparejada | Tipo de emparejamiento o carpeta incorrectos, o el identificador está vacío en tus variantes | Compara la columna Expected SKU con los datos de tus productos |
| Algunas imágenes sin emparejar | Erratas, espacios al final, extensión que falta, sufijo no numérico | Exporta el CSV de imágenes sin emparejar y compáralo con una exportación de productos |
| Imagen emparejada con la variante equivocada | Identificadores duplicados, o una opción “contiene” que coincide con un código más corto | Cambia a una opción exacta o haz únicos los códigos |
| Menos coincidencias con SKU duplicados | Solo se conserva la primera variante con cada identificador | Pídenos el emparejamiento con varias variantes o haz únicos los identificadores |
| El emparejamiento por título falla con tildes | Las tildes se codifican distinto en los nombres de archivo (macOS) y en Shopify | Pide la normalización Unicode o empareja por SKU |
| Los productos editados siguen coincidiendo con valores antiguos | El catálogo está en caché | Pulsa Borrar caché |
| Las imágenes nuevas no aparecen | La lista de la carpeta está en caché | Pulsa Emparejar de nuevo o actualiza el selector de carpeta |
| El emparejamiento agota el tiempo | Catálogo y carpeta muy grandes | Pide un filtro por colección o divide la carpeta |
Mensajes de subida
| Mensaje | Significado | Qué hacer |
|---|---|---|
Image size is larger than 20MB / 20 megapixels | No se pudo redimensionar por debajo del límite | Exporta la imagen más pequeña |
hit the Shopify file rate limit; retrying in Ns | Limitación normal de Shopify | Nada. La app reintenta |
Your shop reached Shopify API rate limit | Otra app u otro trabajo está usando la API | Evita ejecutar dos trabajos grandes a la vez |
Free upload limit reached | Se han usado las 25 imágenes gratuitas | Mejora tu plan |
This folder already in process | Aún hay un trabajo en marcha para la carpeta | Espera o detenlo |
product has only default variant… | La imagen fue al producto, no a una variante | Comportamiento esperado |
El trabajo termina con finished with errors | Algunas imágenes fallaron | Lee las líneas de error. Las imágenes fallidas se reintentan automáticamente |
Lista de comprobación para tu prueba piloto
- Un producto con una imagen recibe una imagen, establecida como imagen de su variante.
- Un producto con varias imágenes las recibe en el orden
_0/_1/_2. - Cada variante de un producto con varias variantes muestra su propia imagen.
- El texto alt en Shopify coincide con la vista previa.
- Un nombre de archivo erróneo a propósito aparece en las imágenes sin emparejar y en el CSV.
- El modo de reemplazo en un producto de prueba deja exactamente el conjunto nuevo.
Obtener ayuda
Contáctanos con el dominio de tu tienda, el nombre de la carpeta, el tipo de emparejamiento, cuándo lo ejecutaste aproximadamente y dos o tres nombres de archivo de ejemplo con el SKU o código de barras con el que deberían haber coincidido. Podemos registrar una traza completa de un emparejamiento y decirte exactamente por qué una imagen coincidió con lo que coincidió.