Por qué mi enlace no funciona: guía práctica de codificación URL
Un espacio de más, un & sin codificar o un parámetro UTM que no deberías haber compartido — casi todos los enlaces rotos que ves en la práctica se reducen a tres o cuatro errores muy concretos de codificación URL. Esta guía los repasa uno por uno con ejemplos reales.
encodeURIComponent vs encodeURI: cuál usar y cuándo
Respuesta rápidaUsa encodeURIComponent() para codificar un solo valor (un texto de búsqueda, un nombre, un parámetro individual). Usa encodeURI() solo cuando ya tengas una URL completa y quieras conservar su estructura (: / ? # & intactos).
Este es, con diferencia, el error más frecuente al construir enlaces a mano: aplicar encodeURI() a un solo valor de parámetro, o pegar un valor sin codificar directamente dentro de una URL completa. Si tienes un texto de búsqueda como «zapatillas de running talla 42» y lo insertas tal cual después de ?q=, el espacio rompe la URL en cuanto un navegador o una API intenta interpretarla — el resultado suele ser un enlace cortado o un error 400.
encodeURIComponent()Codifica un único valor. También convierte caracteres estructurales como & = ? / : #, porque asume que ese valor va DENTRO de otra estructura mayor (una query string, por ejemplo).
encodeURI()Codifica una dirección entera ya formada. Deja intactos los caracteres que la URL necesita para funcionar como URL: : / ? # & =.
En la pestaña «Codificar» de la herramienta puedes alternar entre ambos modos y ver el resultado al instante — pega tu texto, elige «Componente» para un valor suelto o «URI completa» para una dirección entera, y compara cómo cambia el resultado según el modo elegido.
Cómo limpiar parámetros de tracking (UTM, fbclid) de un enlace
Respuesta rápidaPega la URL en la pestaña «Analizar URL» o «Analizar Query»: los parámetros de tracking conocidos (utm_source, utm_medium, utm_campaign, gclid, fbclid) se marcan automáticamente para que los identifiques y los quites antes de compartir el enlace.
Cuando copias un enlace desde una tienda online, una red social o el resultado de un buscador, es habitual que arrastre parámetros de seguimiento que no aportan nada al destinatario y que, en cambio, revelan de dónde venía el clic original. Un ejemplo (ilustrativo, no un caso real) de cómo se ve una URL con y sin esos parámetros:
Parte de la URL
Con tracking
Limpia
Ruta
/producto/zapatillas
/producto/zapatillas
Parámetro funcional
?color=rojo&talla=42
?color=rojo&talla=42
utm_source
&utm_source=instagram
eliminado
fbclid
&fbclid=IwAR123abc
eliminado
La ventaja de analizar primero es que ves cada parámetro por separado, con su clave y su valor ya decodificados, en lugar de tener que leer una cadena larga y confusa a simple vista. Después de identificar qué quitar, la pestaña «Construir Query» te permite volver a montar solo los parámetros que quieres conservar.
Qué es la doble codificación (%2520) y cómo resolverla
Respuesta rápida%2520 es un espacio (%20) que se ha codificado dos veces, porque el símbolo % en sí mismo se convierte en %25. La opción «decodificación multinivel» resuelve todas las capas de una sola vez.
Este problema aparece sobre todo cuando dos sistemas distintos codifican los mismos datos, uno detrás de otro, sin que ninguno de los dos sepa que el otro ya lo hizo — por ejemplo, un formulario que codifica el valor antes de enviarlo y un servidor que lo vuelve a codificar al reenviarlo. El resultado visual es una cadena con %25 repetido delante de otros códigos, en vez del texto legible que esperabas.
En la pestaña «Decodificar», activa el interruptor de decodificación multinivel antes de pegar el valor: la herramienta repite la decodificación capa por capa hasta que ya no queda ningún %XX por resolver, y te muestra el texto final tal como era antes de la primera codificación.
Codificación URL vs Base64: no son lo mismo
Respuesta rápidaLa codificación URL hace seguros los caracteres especiales DENTRO de una URL. Base64 convierte datos en un alfabeto de 64 caracteres para transportarlos como texto plano (tokens, imágenes pequeñas) y no tiene relación con la sintaxis de una URL.
Es habitual confundirlas porque ambas producen cadenas de texto «ilegibles» a simple vista, pero resuelven problemas distintos. Un caso frecuente: si generas una cadena en Base64 y esa cadena contiene los caracteres + o / (parte normal del alfabeto Base64) y luego la insertas como valor de un parámetro en una URL, necesitas aplicarle también codificación URL — de lo contrario esos caracteres pueden confundirse con separadores de la propia URL.
La herramienta incluye ambos modos por separado precisamente por esto: úsalos en el orden correcto (primero Base64 para transformar el dato, después codificación URL si ese resultado va a viajar dentro de un enlace).
¿Necesitas codificar o decodificar algo ahora?
Prueba los 6 modos gratis, directamente en tu navegador — sin registro, sin límites.
¿Cuándo debo usar encodeURIComponent en vez de encodeURI?
Usa encodeURIComponent() cuando vayas a codificar UN SOLO valor, como el contenido de un parámetro de consulta (por ejemplo un texto de búsqueda o un nombre), porque también codifica caracteres estructurales como &, =, ? y /. Usa encodeURI() solo cuando tengas una URL ENTERA ya formada y quieras conservar su estructura, dejando intactos : / ? # & =. Mezclar los dos es la causa más común de enlaces rotos.
¿Por qué mi enlace compartido en redes sociales no funciona?
Casi siempre porque un espacio, una letra acentuada o un símbolo como & se coló sin codificar dentro de un valor de parámetro, y el navegador o la red social corta la URL en ese punto. La solución es codificar cada valor individual con encodeURIComponent antes de insertarlo en la URL final, no la URL completa de golpe.
¿Cómo limpio los parámetros de tracking (UTM, fbclid) de una URL?
Pega la URL en la pestaña «Analizar URL» o «Analizar Query» de la herramienta; los parámetros de tracking conocidos (utm_source, utm_medium, utm_campaign, gclid, fbclid, entre otros) se señalan automáticamente para que puedas identificarlos y eliminarlos antes de compartir el enlace, dejando solo los parámetros funcionales como color o talla.
¿Qué significa un valor doblemente codificado como %2520?
%2520 aparece cuando un %20 (un espacio ya codificado) se codifica una segunda vez, porque el propio carácter % se convierte en %25. Suele pasar cuando dos sistemas distintos codifican los mismos datos por error, uno detrás de otro. La opción de decodificación multinivel resuelve cada capa hasta llegar al texto original en un solo paso.
¿Es lo mismo la codificación URL que la codificación Base64?
No. La codificación URL (porcentual) hace seguros los caracteres especiales dentro de la estructura de una URL. Base64 es una codificación general de datos binarios o de texto en un alfabeto de 64 caracteres, usada por ejemplo en tokens o para incrustar archivos pequeños, y no tiene relación con la sintaxis de una URL — aunque una cadena Base64 a veces necesita a su vez codificación URL porque puede contener + y /.
Nota sobre esta guía: el contenido es informativo y se basa en el comportamiento estándar de las funciones de codificación URL de JavaScript (RFC 3986 / UTF-8) y en la funcionalidad real de la herramienta de ToolPico enlazada arriba. Los ejemplos numéricos de la tabla son ilustrativos, no datos de un caso real. No sustituye asesoría técnica específica para sistemas de producción con requisitos particulares de seguridad o cumplimiento.