Cómo usar el convertidor
- Arma la lista en Excel o Google Sheets: la URL antigua en la primera columna y la nueva en la segunda. Tipo y fecha final son opcionales.
- Copia las celdas y pégalas en el cuadro de arriba, o abre un CSV o TXT.
- Lee la lista de problemas: cada fila muestra el campo, qué está mal y la sugerencia.
- Toma el CSV listo (copiar o descargar) e impórtalo en el Admin, en Storefront > Redirects > Import, o por línea de comandos.
En Opciones eliges el tipo que se usa cuando la fila no lo indica, el formato de las fechas de tu planilla, el dominio de la tienda (para pasar a ruta relativa los destinos del propio dominio) y si las cadenas deben resolverse.
Qué documenta VTEX y qué revisa el convertidor
Las reglas vienen de dos páginas oficiales: la del Admin (Storefront > Redirects) y la de la CLI de VTEX IO. Lo que VTEX documenta aparece como error; lo que no documenta aparece como aviso.
- Separador: el CSV del Admin debe tener punto y coma. La coma y la tabulación no se aceptan, y Google Sheets exporta con coma por defecto. El CSV que se descarga aquí sale con punto y coma.
- Origen (from): solo ruta relativa, sin el dominio. No se aceptan comodines ni variables. Las rutas predefinidas, como home, login y cuenta, no aceptan redirección.
- Destino (to): ruta relativa (/camisas/p) o URL completa (https://otratienda.com). También sin comodín ni variable.
- Tipo (type): TEMPORARY devuelve 302 y PERMANENT devuelve 301.
- Fecha final (endDate): en mm/dd/yyyy, solo en las temporales; en las permanentes queda vacía. El Admin dice que la temporal exige la fecha.
- Encabezado: VTEX pide que la primera fila del archivo no se modifique.
- Avisos (no documentados): cadenas de redirecciones, bucles, mismo origen con destinos distintos, filas repetidas, origen con query string y fecha final que ya pasó.
Las cuatro columnas
from: la URL antigua, como ruta (por ejemplo,/blusa/p).to: la URL nueva, como ruta o URL completa.type:PERMANENToTEMPORARY.endDate: fecha final enmm/dd/yyyy, solo para TEMPORARY.
Estos nombres vienen de la página de la CLI. La página del Admin no lista los nombres de las columnas del CSV: si el archivo exportado de tu panel tiene otro encabezado, pega su primera fila en el campo "Encabezado del archivo" y el convertidor pasa a usarlo.
Cadenas y bucles: por qué resolverlos
Una cadena ocurre cuando el destino de una redirección es el origen de otra (A lleva a B y B lleva a C). El visitante y Google pasan por dos saltos para llegar al destino final. El convertidor muestra cada cadena y, con la opción activada, apunta A directo a C. Un bucle (A lleva a B y B vuelve a A) nunca llega a ningún lado: se marca y no se modifica, porque solo tú sabes qué destino vale.
Migración de tienda: una guía corta
- Lista todas las URL antiguas que tienen tráfico o enlaces y la URL nueva de cada una.
- Usa PERMANENT para lo que cambió de dirección para siempre y TEMPORARY, con fecha final, para promociones y páginas de temporada.
- Antes de importar, exporta las redirecciones que ya existen (botón Export en el Admin o el comando de exportación de la CLI) para tener una copia.
- Importa y revisa algunos casos en el navegador: VTEX dice que el procesamiento puede tardar un tiempo hasta que las redirecciones valgan.
Qué no hace el convertidor
- No envía nada a VTEX: solo prepara el archivo.
- No lee .xlsx: copia las celdas o abre un CSV.
- No comprueba que las URL nuevas existan en tu tienda.
- No conoce el límite de filas de un archivo: VTEX no lo documenta.
¿Quieres captar contactos de quien llega por las URL redirigidas? Conoce la ruleta de descuentos para VTEX, con app oficial en la VTEX App Store.
Preguntas frecuentes sobre redirecciones masivas en VTEX
¿Cómo importar redirecciones masivas en VTEX?
Hay dos caminos. En el Admin, en Storefront > Redirects, haz clic en Import, elige el CSV, haz clic en Import File y luego en Save. Con la CLI de VTEX IO, instala el plugin (vtex plugins install redirects), inicia sesión en la cuenta y ejecuta vtex redirects import con la ruta del CSV.
¿Por qué el Admin rechaza el CSV que exporté de Google Sheets?
Porque Google Sheets exporta con coma como separador, y el Admin exige punto y coma. La coma y la tabulación no se aceptan. Este convertidor entrega el CSV ya con punto y coma.
¿Cuáles son las columnas del CSV de redirecciones?
En la CLI de VTEX IO son cuatro: from, to, type y endDate. La página del Admin no lista los nombres de las columnas. Si el archivo exportado de tu panel tiene otro encabezado, copia su primera fila en el campo de encabezado del convertidor.
¿Se puede modificar el encabezado del CSV?
No. VTEX avisa que, si la primera fila se modifica, no será posible crear ni borrar redirecciones. Por eso el CSV generado aquí no lleva BOM ni ningún carácter antes del primer nombre.
¿Cuál es la diferencia entre PERMANENT y TEMPORARY?
PERMANENT devuelve el estado 301 y TEMPORARY devuelve 302. Usa permanente cuando la página cambió de dirección para siempre y temporal para promociones y páginas de temporada.
¿Cómo lleno la fecha final (endDate)?
En mm/dd/yyyy, por ejemplo 12/31/2026, y solo en las redirecciones TEMPORARY. En las PERMANENT queda vacía. El Admin informa que la redirección temporal exige fecha final. El convertidor lee fechas como 2026-12-31 o 31/12/2026 y las convierte.
¿Puedo usar comodines o expresiones regulares en la redirección?
No. VTEX dice que no es posible crear redirecciones con comodines o variables: cada redirección es un origen y un destino exactos.
¿El origen (from) puede llevar el dominio?
No. La columna from solo acepta ruta relativa, y en el Admin el origen se llena sin el nombre del dominio. El convertidor quita el dominio cuando pegas una URL completa.
¿El destino (to) acepta una URL completa?
Sí. El destino acepta ruta relativa, como /camisas/p, o URL completa, como https://otratienda.com.
¿Puedo redirigir la home, el login o la cuenta?
No. VTEX dice que no se pueden crear redirecciones de rutas predefinidas, como home, login y cuenta. El convertidor marca esos orígenes como error.
¿Puedo tener más de una redirección para la misma URL?
La página del Admin informa que es posible definir varias redirecciones desde una sola URL. Como en una planilla suele ser un error, el convertidor muestra un aviso cuando el mismo origen aparece con destinos distintos.
¿Se reenvían los parámetros de la URL (query string)?
Por defecto, no: VTEX informa que los parámetros de query string no se reenvían en las redirecciones. El convertidor avisa cuando el origen tiene query string, porque ese caso no está documentado.
¿Cuál es el límite de redirecciones por archivo?
Las páginas consultadas no informan un límite de filas ni de tamaño del CSV. La única cantidad citada es 1.024 redirecciones, como umbral para el flujo beta (flag enableRedirects) de las tiendas FastStore.
¿Cómo exporto las redirecciones que ya existen?
En el Admin, con el botón Export en la pantalla de Redirects. Con la CLI, con vtex redirects export seguido del nombre del archivo .csv. Conviene exportar antes de importar para guardar una copia.
¿Cómo borro redirecciones de forma masiva?
Con la CLI, usando vtex redirects delete y la ruta de un CSV. El archivo usa el mismo modelo de cuatro columnas de la creación, con las redirecciones a eliminar debajo de la primera fila.
¿Cuánto tardan en valer las redirecciones?
VTEX solo dice que, una vez procesado el archivo, las redirecciones empiezan a valer y que esto puede tardar un tiempo. Revisa algunos casos en el navegador después de importar.
¿Necesito algún permiso para importar?
En el Admin, el usuario necesita un rol con el recurso CMS Settings del License Manager. Con la CLI, hay que instalar el VTEX IO CLI, el plugin de redirects e iniciar sesión en la cuenta.
¿Qué es una cadena de redirecciones y por qué evitarla?
Es cuando el destino de una redirección es el origen de otra: A lleva a B y B lleva a C. Cada salto es una solicitud más para el visitante y para Google. Lo ideal es que A apunte directo a C. El convertidor muestra las cadenas y, si dejas la opción activada, las resuelve.
¿Qué es un bucle de redirecciones?
Es cuando el camino vuelve al origen: A lleva a B y B lleva a A. La página nunca carga. El convertidor marca el bucle y no modifica esas filas, porque solo tú sabes qué destino vale.
¿Funciona con Store Framework y con FastStore?
VTEX informa que las tiendas con Store Framework tienen la función de forma nativa y que las tiendas FastStore siguen una guía propia de redirecciones. El formato de CSV descrito aquí es el del Admin y de la CLI de VTEX IO.
¿El convertidor lee archivos .xlsx?
No. Copia las celdas de la planilla y pégalas en el cuadro, o abre un archivo CSV o TXT. Así tu archivo no se envía a ninguna parte.
¿Los datos de mi lista se envían a algún servidor?
No. La lectura, la validación y la conversión ocurren en tu navegador. La herramienta no envía ni guarda nada.
Otras herramientas para tiendas online
En el navegador, sin enviar nada, también puedes:
- validar la planilla de envíos de VTEX antes de subirla
- redimensionar las fotos de producto al tamaño de tu tienda
- generar códigos de barras EAN-13 y UPC-A
Otras herramientas gratuitas
Todas funcionan en el navegador, sin registro y sin subir tus archivos:
- Generador de link de WhatsApp: Crea enlaces wa.me con mensaje predefinido y úsalos en tu sitio, en Instagram o en anuncios.
- Generador de códigos QR: Crea códigos QR para enlaces, WhatsApp, Instagram, Google Reviews, contactos y otros destinos.
- Calculadora de premios para ruleta: Descubre qué premios poner en tu ruleta de descuentos, según el rubro, el ticket promedio y el objetivo.
- Redimensionar imágenes: Redimensiona imágenes por píxeles o porcentaje, recorta, ajusta la calidad y descarga varias a la vez en ZIP.
- Convertir imagen: Convierte imágenes entre JPG, PNG y WebP sin cambiar el tamaño en píxeles, con calidad ajustable y descarga en ZIP.
- Imagen a PDF: Une una o varias imágenes en un solo PDF, una por página, en el orden que elijas.