Si utilizas WPForms en WordPress y al enviar un formulario aparece el mensaje “The form was unable to submit”, normalmente significa que algún elemento está impidiendo que WPForms valide correctamente el envío.
Aunque puede parecer un problema grave, en muchos casos el culpable está relacionado con la caché, JavaScript, la protección antispam o la optimización de la página.
La buena noticia es que puedes localizar el origen del error siguiendo unas comprobaciones bastante sencillas sin necesidad de reconstruir tu formulario desde cero.
En este tutorial vas a aprender cómo solucionar el error “The form was unable to submit” en WPForms empezando por las causas más habituales y avanzando hacia problemas menos frecuentes.
¿Qué significa “The form was unable to submit” en WPForms?
El mensaje “The form was unable to submit. Please contact the site administrator” aparece cuando WPForms recibe el intento de envío pero no puede validarlo correctamente.
Uno de los motivos más habituales es una discrepancia entre el token de seguridad generado por WPForms y el token almacenado en la versión de la página que está viendo el visitante.
WPForms utiliza estos mecanismos para determinar que el envío procede realmente del formulario y para ayudar a proteger tu página frente a spam y envíos automatizados.
El problema puede aparecer cuando una página permanece almacenada demasiado tiempo en caché y contiene información de validación que ya ha dejado de ser válida.
De hecho, WPForms recomienda que la duración de la caché no supere la validez de sus tokens y señala especialmente los periodos de más de 48 horas como posibles causantes del problema.
Tabla resumen de causas y soluciones
| Problema | Síntoma habitual | Solución recomendada |
|---|---|---|
| Caché antigua | El formulario funciona después de borrar caché | Reducir la duración de la caché |
| Optimización JavaScript | El botón funciona mal o no ocurre nada | Excluir scripts de WPForms |
| Conflicto con plugins | El error aparece después de instalar o actualizar algo | Desactivar plugins temporalmente |
| Conflicto con el tema | WPForms funciona con otro tema | Revisar JavaScript y funciones del tema |
| AJAX bloqueado | El formulario no puede completar el envío | Revisar firewall y admin-ajax.php |
| Protección antispam | Algunos usuarios pueden enviar y otros no | Revisar CAPTCHA y filtros |
| CDN o caché externa | Borrar la caché de WordPress no soluciona nada | Vaciar también CDN y caché del servidor |
Cómo solucionar “The form was unable to submit” paso a paso
Para encontrar el problema rápidamente es recomendable seguir este orden de comprobaciones, ya que empezar por las soluciones más sencillas puede ahorrarte bastante tiempo.
- Actualiza WPForms y WordPress desde Escritorio → Actualizaciones para asegurarte de que no estás utilizando versiones antiguas o incompatibles.
- Borra completamente la caché de tu plugin de caché, navegador, servidor y CDN antes de volver a probar el formulario.
- Abre una ventana de incógnito y realiza un envío desde ella para comprobar que no estás cargando una versión antigua de la página.
- Reduce la duración de la caché a menos de 48 horas si actualmente mantienes las páginas almacenadas durante periodos superiores.
- Desactiva temporalmente la optimización de JavaScript, especialmente las opciones de retrasar, combinar, aplazar o minificar scripts.
- Comprueba la configuración antispam entrando en WPForms → Editar formulario → Ajustes → Protección contra spam y seguridad.
- Prueba el formulario sin CAPTCHA durante unos minutos para comprobar si reCAPTCHA, hCaptcha o Cloudflare Turnstile están provocando el conflicto.
- Desactiva temporalmente otros plugins de optimización, seguridad o rendimiento y prueba nuevamente el envío.
- Comprueba el tema activo utilizando temporalmente un tema estándar de WordPress si las pruebas anteriores no han localizado el problema.
- Contacta con tu hosting para comprobar si ModSecurity, un firewall u otra regla del servidor está bloqueando las peticiones AJAX de WordPress.
Borra la caché de WordPress
La primera prueba que deberías realizar es vaciar completamente la caché de tu página, porque esta es una de las causas más frecuentes de este error.
Si utilizas plugins como LiteSpeed Cache, WP Rocket, W3 Total Cache o similares, busca la opción denominada Purge Cache, Clear Cache o Vaciar caché.
También debes tener en cuenta que algunos alojamientos web incorporan su propio sistema de caché, por lo que borrar únicamente la caché del plugin puede no ser suficiente.
Si además utilizas Cloudflare u otra CDN, elimina temporalmente la caché almacenada allí para asegurarte de que tus visitantes reciben una versión reciente del formulario.
Puedes consultar también la documentación oficial de WPForms sobre problemas relacionados con la caché si quieres revisar este comportamiento con más detalle.
Reduce la duración de la caché
Borrar la caché puede solucionar el error inmediatamente, pero no evitará que vuelva a aparecer si tu configuración continúa almacenando las páginas durante demasiado tiempo.
WPForms genera tokens relacionados con su sistema antispam que cambian periódicamente, mientras que una página almacenada durante demasiado tiempo puede continuar mostrando un token antiguo al visitante.
Por este motivo es recomendable configurar tu plugin de caché para que la duración de las páginas sea inferior a 48 horas.
Una configuración de 10, 12 o 24 horas suele ser perfectamente razonable para la mayoría de páginas WordPress y reduce las posibilidades de encontrarte con formularios almacenados durante demasiado tiempo.
Revisa la optimización de JavaScript
Otra causa habitual aparece cuando un plugin de rendimiento modifica la forma en la que se cargan los archivos JavaScript utilizados por WPForms.
Opciones como Delay JavaScript, Defer JavaScript, Combine JS o Minify JavaScript pueden mejorar la velocidad de una página, pero determinadas configuraciones pueden interferir con scripts que necesitan ejecutarse inmediatamente.
WPForms depende de JavaScript para funciones como la validación de campos, la lógica condicional, algunos sistemas CAPTCHA y otras características del formulario.
Desactiva temporalmente estas funciones de optimización, vacía la caché y realiza nuevamente una prueba para comprobar si el formulario vuelve a enviarse correctamente.
Si el formulario funciona después de hacerlo, no necesitas desactivar permanentemente toda la optimización, ya que normalmente puedes excluir los scripts problemáticos desde la configuración del plugin de rendimiento.
Comprueba la protección antispam de WPForms
WPForms incorpora diferentes mecanismos destinados a bloquear bots y envíos fraudulentos, pero una configuración incorrecta también puede impedir determinados envíos legítimos.
Puedes revisar estas opciones entrando en WPForms → Todos los formularios → Editar → Ajustes → Protección contra spam y seguridad.
Dentro encontrarás diferentes sistemas dependiendo de tu versión y configuración, incluyendo la protección antispam moderna, filtros adicionales y servicios CAPTCHA.
La protección antispam moderna de WPForms depende de que JavaScript funcione correctamente, por lo que un problema con los scripts también puede terminar manifestándose como un fallo de envío.
Puedes consultar las opciones disponibles en la guía de protección contra spam de WPForms para conocer las distintas alternativas.
Comprueba reCAPTCHA, hCaptcha o Turnstile
Si has configurado algún sistema CAPTCHA, realiza una prueba desactivándolo temporalmente para saber si la validación externa está bloqueando el formulario.
Los plugins de optimización pueden retrasar determinados scripts de CAPTCHA y provocar que la comprobación todavía no se haya completado cuando el visitante pulsa el botón Enviar.
Algo similar puede ocurrir cuando existen restricciones de cookies, bloqueadores de scripts, configuraciones agresivas de consentimiento o reglas específicas aplicadas mediante un firewall o CDN.
Si después de retirar temporalmente el CAPTCHA WPForms funciona correctamente, ya sabes que debes centrar la investigación en ese sistema de protección o en la carga de sus scripts.
Comprueba si existe un conflicto con otro plugin
WordPress permite que muchos plugins carguen código simultáneamente y ocasionalmente puede producirse un conflicto entre WPForms y otra extensión.
Los primeros plugins que deberías comprobar son los relacionados con seguridad, caché, optimización, JavaScript, cookies, CAPTCHA y firewalls.
Desactívalos temporalmente uno a uno y prueba el formulario después de cada cambio hasta localizar exactamente qué plugin está desencadenando el problema.
Cuando encuentres el responsable puedes revisar sus ajustes, buscar una actualización o crear una exclusión para evitar que modifique los scripts utilizados por WPForms.
Comprueba si AJAX está siendo bloqueado
WPForms permite realizar envíos mediante AJAX, haciendo posible procesar formularios sin necesidad de recargar completamente la página.
Puedes comprobar esta configuración entrando en el formulario y accediendo a Ajustes → General → Avanzado → Activar envío de formularios AJAX.
Si las peticiones AJAX son bloqueadas por un firewall, por ModSecurity o por determinadas reglas del servidor, WPForms puede encontrarse con problemas al procesar correctamente el envío.
En este caso puedes pedir a tu empresa de hosting que revise si existen bloqueos relacionados con admin-ajax.php, ModSecurity o el firewall del servidor.
Actualiza WPForms
Antes de realizar modificaciones avanzadas conviene comprobar también que estás utilizando una versión actualizada de WPForms.
Las actualizaciones pueden incluir correcciones relacionadas con compatibilidad, JavaScript, seguridad y funcionamiento con versiones recientes de WordPress o PHP.
Entra en Escritorio → Actualizaciones y comprueba si existen actualizaciones pendientes tanto para WPForms como para los complementos asociados al plugin.
WPForms incluye además una guía general para diagnosticar problemas habituales del plugin que puede ser útil cuando el fallo continúa después de las comprobaciones básicas.
Cómo saber si has solucionado el problema
Después de cada modificación debes borrar nuevamente la caché antes de comprobar el formulario, ya que de lo contrario podrías continuar viendo una versión anterior de la página.
Realiza después varios envíos utilizando una ventana de incógnito y, si puedes, comprueba también el formulario desde otro navegador o dispositivo.
Verifica además que la entrada aparece correctamente dentro de WPForms → Entradas y que recibes las notificaciones configuradas para ese formulario.
Si el mensaje “The form was unable to submit” ha desaparecido y las entradas se registran normalmente, puedes considerar que el problema está solucionado.
Conclusión
Cuando WPForms muestra “The form was unable to submit”, lo más habitual es que exista un problema relacionado con la caché o con la carga y validación de los scripts del formulario.
Empieza siempre por vaciar la caché, reducir su duración y revisar las optimizaciones de JavaScript, ya que estas comprobaciones resuelven una gran parte de los casos.
Si el error continúa, revisa después CAPTCHA, protección antispam, conflictos entre plugins, AJAX y las reglas de seguridad del servidor.
Siguiendo este orden podrás localizar la causa con mucha más facilidad y conseguir que tus formularios WPForms vuelvan a enviar los datos correctamente sin necesidad de sustituir el plugin ni crear el formulario desde cero.
