Si estás intentando añadir un formulario y descubres que WPForms no aparece en Gutenberg, normalmente estás ante un problema de configuración, caché, compatibilidad o carga del propio editor de WordPress.
La buena noticia es que, en la mayoría de los casos, puedes recuperar el bloque de WPForms sin reinstalar WordPress ni realizar cambios complicados en tu página web.
WPForms dispone de un bloque específico para el editor de WordPress, desde el que puedes seleccionar cualquiera de tus formularios y mostrarlo directamente dentro de una entrada o página.
En este tutorial vas a ver por qué WPForms puede desaparecer de Gutenberg y qué debes comprobar paso a paso para solucionar el problema.
🔎 Comprueba primero que WPForms está instalado y activado
Puede parecer demasiado evidente, pero lo primero que debes revisar es que WPForms continúa activo en tu instalación de WordPress.
Una actualización, una migración, una restauración de copia de seguridad o una intervención de mantenimiento pueden provocar que un plugin termine desactivado accidentalmente.
Sigue estos pasos para comprobarlo:
- Entra en Plugins > Plugins instalados desde el escritorio de WordPress.
- Busca WPForms Lite o WPForms Pro dentro de la lista.
- Comprueba que debajo del nombre aparece la opción Desactivar, ya que eso confirma que el plugin se encuentra activo.
- Si aparece el botón Activar, púlsalo y vuelve posteriormente al editor de Gutenberg.
Una vez activado WPForms, abre nuevamente tu página y busca el bloque escribiendo WPForms en el buscador de bloques.
🧩 Busca correctamente el bloque de WPForms
Otro problema frecuente es pensar que WPForms ha desaparecido cuando simplemente no estás buscando el bloque desde el lugar adecuado.
Abre una página o entrada con Gutenberg y pulsa el botón + situado en la parte superior o dentro del área de contenido.
Escribe WPForms en el cuadro de búsqueda y debería aparecer el bloque del plugin, que también puede localizarse dentro de la categoría de widgets del editor.
También puedes escribir /wpforms directamente en una línea vacía del editor para comprobar si WordPress te ofrece el bloque entre las sugerencias disponibles.
Puedes consultar el funcionamiento general del sistema de bloques en la documentación del editor de bloques de WordPress si necesitas familiarizarte con esta interfaz.
📝 Comprueba que realmente estás utilizando Gutenberg
Si no encuentras ningún bloque de WPForms, fíjate en si la pantalla desde la que estás editando corresponde realmente al editor de bloques Gutenberg.
Algunos sitios todavía utilizan el Editor clásico, ya sea mediante un plugin específico, mediante código personalizado o por una configuración aplicada al tipo de contenido que estás intentando modificar.
Si únicamente aparece un gran editor de texto parecido a un procesador de textos tradicional y no puedes insertar bloques independientes, probablemente Gutenberg no está activo en esa pantalla.
En ese caso, revisa los plugins instalados buscando extensiones como Classic Editor o cualquier herramienta destinada a sustituir o desactivar el editor de bloques.
Ten también presente que determinados tipos de contenido personalizados pueden haber sido configurados expresamente para no utilizar Gutenberg.
🔄 Actualiza WordPress y WPForms
Una versión antigua de WordPress combinada con una versión reciente de WPForms, o viceversa, puede provocar errores de compatibilidad en el editor.
WPForms recomienda comprobar, entre otras cosas, que tanto el propio plugin como WordPress estén actualizados cuando aparecen problemas de funcionamiento.
Para actualizar tu instalación:
- Entra en Escritorio > Actualizaciones.
- Comprueba si existe una nueva versión de WordPress.
- Accede después a Plugins > Plugins instalados.
- Actualiza WPForms si existe una versión más reciente.
- Actualiza también los demás plugins pendientes siempre que hayas realizado previamente una copia de seguridad.
- Abre de nuevo Gutenberg y comprueba si aparece WPForms.
Mantener los componentes actualizados no solo puede resolver este problema, sino que también resulta fundamental para la seguridad y estabilidad de WordPress.
⚠️ Comprueba si existe un conflicto con otro plugin
Los conflictos entre plugins son una de las explicaciones más probables cuando un bloque que anteriormente funcionaba deja repentinamente de aparecer.
Gutenberg depende considerablemente de JavaScript y un error provocado por cualquier otro plugin puede impedir que determinados bloques terminen de registrarse o cargarse correctamente.
Puedes hacer esta comprobación:
- Realiza primero una copia de seguridad de tu web.
- Desactiva temporalmente todos los plugins excepto WPForms.
- Abre una página utilizando Gutenberg.
- Busca nuevamente el bloque de WPForms.
- Si ahora aparece, activa los demás plugins uno por uno.
- Comprueba Gutenberg después de activar cada plugin hasta localizar el que genera el conflicto.
WordPress también dispone del plugin Health Check & Troubleshooting, que permite realizar determinadas pruebas de compatibilidad sin afectar de la misma manera a los visitantes de la web.
Este método puede resultarte especialmente útil en una página en producción donde no quieres desactivar públicamente todos los complementos.
🎨 Descarta un conflicto con tu tema de WordPress
Aunque resulta menos frecuente, tu tema activo también puede interferir con Gutenberg debido a código obsoleto, personalizaciones o errores JavaScript.
Para descartarlo puedes activar temporalmente uno de los temas oficiales de WordPress y abrir nuevamente el editor.
Si el bloque de WPForms aparece utilizando el tema predeterminado, probablemente deberás revisar las personalizaciones de tu tema original o contactar con su desarrollador.
No necesitas mantener el tema alternativo activo permanentemente, ya que esta prueba sirve únicamente para aislar el origen del problema.
🧹 Limpia la caché de WordPress y del navegador
La caché también puede conseguir que Gutenberg cargue archivos antiguos de JavaScript o CSS aunque hayas actualizado WPForms recientemente.
Esto resulta especialmente habitual cuando utilizas plugins de caché, sistemas de optimización, CDN o herramientas que combinan y minimizan archivos JavaScript.
Para descartarlo:
- Vacía la caché de tu plugin de optimización.
- Purga la caché de tu hosting si dispone de ella.
- Limpia la caché de cualquier CDN que utilices.
- Borra la caché del navegador.
- Prueba el editor desde una ventana privada o de incógnito.
- Vuelve a buscar WPForms dentro de Gutenberg.
WordPress reconoce que tanto la caché del navegador como la caché del servidor y de los plugins pueden provocar que continúe mostrándose información almacenada anteriormente.
🚀 Desactiva temporalmente la optimización de JavaScript
Si utilizas herramientas de rendimiento, presta especial atención a las funciones de minificación, combinación, retraso o aplazamiento de JavaScript.
Algunas configuraciones agresivas pueden impedir que determinados scripts utilizados dentro del administrador de WordPress se ejecuten correctamente.
Desactiva temporalmente estas funciones, limpia todas las cachés y vuelve a comprobar Gutenberg.
Si WPForms aparece después de hacerlo, tendrás que revisar las exclusiones JavaScript de tu herramienta de optimización en lugar de mantenerla completamente desactivada.
🔐 Revisa las restricciones sobre los bloques disponibles
WordPress permite que plugins, temas o fragmentos de código limiten los bloques que pueden utilizarse dentro del editor.
Esto es habitual en webs corporativas donde un desarrollador restringe Gutenberg para evitar que otros usuarios modifiquen determinados elementos.
Si WPForms está activo y funciona correctamente en otras zonas pero su bloque no aparece para determinados usuarios, comprueba también los permisos y personalizaciones de tu instalación.
Revisa especialmente los plugins relacionados con roles de usuario, administración de Gutenberg, seguridad y personalización del escritorio.
🛠️ Utiliza el botón Insertar de WPForms
No necesitas localizar obligatoriamente el bloque manualmente, ya que WPForms incorpora su propio sistema para insertar formularios en páginas existentes o nuevas.
Entra en WPForms > Todos los formularios, edita el formulario correspondiente y utiliza la opción Insertar disponible en el constructor.
Desde allí podrás elegir una página existente o crear una página nueva y WPForms intentará colocar el formulario directamente en el editor.
Puedes consultar todas las posibilidades en la guía oficial para mostrar formularios de WPForms.
💻 Inserta WPForms mediante shortcode como solución alternativa
Si Gutenberg funciona pero el bloque continúa sin aparecer, todavía puedes insertar el formulario utilizando su shortcode.
WPForms permite obtener el shortcode directamente desde su asistente de inserción y pegarlo en cualquier zona de WordPress compatible con shortcodes.
El código tendrá una estructura similar a esta:
[wpforms id="123"]
Simplemente debes sustituir 123 por el ID real de tu formulario o copiar directamente el shortcode proporcionado por WPForms para evitar errores.
Dentro de Gutenberg puedes añadir un bloque Shortcode, pegar el código y guardar la página.
Esta alternativa resulta especialmente interesante si necesitas publicar el formulario inmediatamente mientras investigas por qué no aparece su bloque específico.
📊 Tabla resumen de causas y soluciones
| Problema | Posible causa | Solución recomendada |
|---|---|---|
| WPForms no aparece | Plugin desactivado | Activar WPForms |
| No encuentras ningún bloque | Editor clásico activo | Habilitar Gutenberg |
| El bloque desapareció tras actualizar | Caché antigua | Vaciar todas las cachés |
| Gutenberg funciona incorrectamente | Conflicto entre plugins | Desactivar plugins y probar uno por uno |
| El problema depende del diseño | Conflicto con el tema | Probar temporalmente un tema oficial |
| El bloque aparece para unos usuarios y para otros no | Permisos o restricciones | Revisar roles y configuración de Gutenberg |
| WPForms sigue sin aparecer | Error JavaScript | Desactivar temporalmente optimizaciones |
| Necesitas mostrar el formulario urgentemente | Bloque no disponible | Utilizar el shortcode de WPForms |
✅ ¿Qué hacer si WPForms sigue sin aparecer en Gutenberg?
Si has realizado todas las comprobaciones anteriores y WPForms sigue sin aparecer en Gutenberg, probablemente exista un conflicto específico de tu instalación que requiera un diagnóstico algo más profundo.
Revisa la consola del navegador en busca de errores JavaScript, consulta la herramienta Salud del sitio de WordPress y comprueba si tu hosting muestra errores relacionados con PHP.
También puedes reinstalar WPForms después de realizar una copia de seguridad, aunque normalmente es preferible identificar primero el origen del conflicto antes de empezar a reinstalar componentes.
En la mayoría de instalaciones, comprobar la activación de WPForms, actualizar los plugins, limpiar la caché y descartar conflictos suele ser suficiente para conseguir que el bloque vuelva a aparecer.
Una vez recuperado, solamente tienes que añadir el bloque WPForms, seleccionar tu formulario en el desplegable y publicar o actualizar la página para volver a utilizarlo normalmente.
🏁 Conclusión
Cuando WPForms no aparece en Gutenberg, no significa necesariamente que tus formularios estén dañados o que tengas que crearlos nuevamente.
Lo más habitual es encontrarte ante un problema de caché, compatibilidad, configuración del editor o conflicto con otro plugin.
Empieza siempre por las comprobaciones sencillas y avanza progresivamente hacia las pruebas de plugins, temas y JavaScript, ya que así podrás encontrar la causa sin realizar cambios innecesarios en tu web.
