Tres síntomas, una causa: cómo se guardó el archivo
| Lo que ves | Causa probable |
|---|---|
Letras raras: Café, niño, “ | El archivo no está guardado en UTF-8 |
| Todo el encabezado en una sola celda, o columnas desplazadas | El archivo usa punto y coma o tabulaciones en lugar de comas |
| “Comillas no válidas en la línea” o “Comilla faltante o fuera de lugar en la línea” | Un carácter que no es UTF-8, comillas tipográficas (“ ”) o una comilla de más o de menos |
Qué exige Shopify
- Los encabezados van en la primera línea y las columnas se separan con comas.
- El archivo debe guardarse en UTF-8 (con saltos de línea tipo LF, según su documentación).
- Las comillas y los apóstrofos deben ser caracteres UTF-8 en la posición correcta. Shopify recomienda reemplazar las comillas tipográficas por comillas rectas cuando Excel las introduce donde no corresponde.
- Si tras importar ves caracteres extraños, Shopify indica que el archivo probablemente no estaba en UTF-8 y recomienda volver a guardarlo en ese formato.
Tildes, ñ y signos ¿ ¡: cómo se ven cuando falla la codificación
Si un archivo UTF-8 se lee como Windows-1252 (o al revés), las letras con tilde se descomponen en dos o más caracteres. Estas son las más frecuentes en español:
| Debería verse | Se ve así | Debería verse | Se ve así |
|---|---|---|---|
| á | á | ñ | ñ |
| é | é | ü | ü |
| ó | ó | ¿ | ¿ |
| ú | ú | ¡ | ¡ |
Todo en una columna: el punto y coma
En muchas configuraciones regionales, entre ellas varias de Latinoamérica donde se usa coma decimal (por ejemplo Argentina, Chile o Colombia), Excel usa el punto y coma como separador de listas. Aunque elijas “CSV (delimitado por comas)”, el archivo puede salir con punto y coma, porque Excel toma el separador de la configuración del sistema. Para comprobarlo, abre el archivo en el Bloc de notas: si la primera línea es Handle;Title;Variant Price, ese es el problema.
Tienes tres salidas: exportar desde Google Sheets (que escribe comas), cambiar el separador de listas del sistema (en Windows suele estar en Panel de control → Región → Formatos → Configuración adicional → Separador de listas; los nombres pueden variar según la versión), o dejar que ShopiClean convierta el archivo.
“Comillas no válidas en la línea”
Shopify lo explica así: el archivo necesita estar en UTF-8, y a veces hay una comilla faltante, de más o tipográfica. Los casos más comunes en catálogos en español:
- Una comilla doble suelta dentro de un campo, por ejemplo una descripción con una medida en pulgadas:
Pantalla de 24" con base. Dentro de un campo, la comilla debe escaparse duplicándola o el campo debe ir entre comillas. - Comillas tipográficas (“ ”) que Excel o Word insertan automáticamente. Para limpiarlas, abre el archivo en un editor de texto y busca y reemplaza esas comillas por comillas rectas donde actúen como delimitadores.
- Una comilla de apertura sin cierre: puede “tragarse” las filas siguientes. Revisa el archivo cerca de la línea que indica Shopify.
Cómo exportar bien desde cada programa
Los nombres de los menús pueden variar según la versión y el idioma del programa.
| Programa | Qué elegir |
|---|---|
| Excel | Archivo → Guardar como y, en el tipo de archivo, CSV UTF-8 (delimitado por comas) (*.csv). La opción “CSV (delimitado por comas)” sin “UTF-8” no guarda en UTF-8. |
| Google Sheets | Archivo → Descargar → Valores separados por comas (.csv). Shopify indica que Google Sheets guarda en UTF-8 por defecto. |
| Apple Numbers | Archivo → Exportar a → CSV… y en “Codificación de texto” elige Unicode (UTF-8). |
| LibreOffice Calc | Archivo → Guardar como → Texto CSV, marca “Editar configuración de filtro” y elige juego de caracteres Unicode (UTF-8) y separador de campos ,. |
Comprueba el archivo en un editor de texto antes de importar
- Ábrelo en el Bloc de notas, Notepad++ o VS Code, no en Excel. Lo que ves ahí es lo que recibe Shopify.
- Mira la primera línea: las columnas deben ir separadas por comas, no por punto y coma ni tabulaciones.
- Busca un producto con tilde o ñ y confirma que se ve bien.
- Mira la barra de estado del editor: debe indicar UTF-8.
Qué hace ShopiClean con la codificación, los separadores y las comillas
Transparencia: ShopiClean es nuestro propio producto. Todo lo que aparece en esta guía se puede hacer a mano en una hoja de cálculo; la herramienta solo automatiza las revisiones. El análisis gratuito y la vista previa en pantalla de hasta 5 filas reparadas no tienen costo, y descargar el archivo reparado requiere el Pase de 7 días ($9 USD, pago único).
Las pruebas de ShopiClean que se mencionan aquí se hicieron el 21 de octubre de 2026 con archivos de ejemplo.
Qué hace:
- Detecta un archivo en Windows-1252 (una exportación frecuente de Excel) y guarda el resultado en UTF-8.
- Convierte archivos separados por punto y coma o tabulaciones en archivos separados por comas.
- Escapa las comillas dobles sueltas dentro de los campos.
- Conserva las tildes y la ñ en títulos y descripciones. En los handles las reemplaza por letras sin acento (por ejemplo
Camiseta niñopasa acamiseta-nino), porque un handle no admite acentos.
Qué no hace:
- No repara texto que ya está dañado. En la prueba, un archivo que contenía literalmente
Cafésalió igual y sin ningún aviso. Hay que corregirlo en la fuente original. - No puede reparar una comilla de apertura que nunca se cierra: puede unir filas, así que revisa el archivo de origen.
- La detección de la codificación es una estimación: revisa algunas palabras con tilde en el archivo resultante.
Fuentes y cómo se revisó esta guía
Los comportamientos de Shopify descritos aquí se revisaron en las páginas del Centro de ayuda de Shopify que aparecen abajo entre el 19 y el 21 de octubre de 2026. Shopify puede cambiar su sistema de importación; si algo difiere de lo que ves, confía en la documentación de Shopify.